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PREFACE 


This manual has been made up to discuss the programming language called MSX 
BASIC for the Sanyo Personal Computer. If falls into the following six chapters. 
Please read carefully, together with the Operating Instructions, for your applications. 
The Operating Instructions, an independent volume, gives in details how to use the 
personal computer and peripheral units. 


Note: 

1) These programming manual may not be copied or published either in whole or in 
part without permission of Sanyo. 

2) These programming manual may be revised or changed with or without notice. 

3) Sanyo assumes no liability whatsoever for any claim arising from the use of this 
computer. 


is the registered tradernark of Microsoft Corp., U.S.A. 
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The utilization of each MSX-BASIC command and function is explained in this 
manual. Also, additional explanations and explanations that cover several groups of 
commands are provided in chapter 4 with actual examples. 

Please use this manual to learn MSX-BASIC or for actual MS X-BASIC programming. 


1 WHAT IS BASIC ? 


Computers run on a machine language which is a combination of 0 and 1, How- 
ever the use of the machine language is difficult. A more simplified language, 
called BASIC, or an acronym for Beginners All-purpose Symbolic Instruction 
Code is used with this computer. 


2 EXECUTION OF COMMAND 


All commands are executed by typing RETURN key ( [-]] ) after commands are 
typed in with keys on the keyboard. 


Taking PRINT command as an example, this subsection will explain the use of 
the BASIC language to display alphanumeric characters on the screen. To begin 
with, clear the screen by typing SHIFT] + [CLS HOME]. 


2-1 DISPLAY OF ALPHANUMERIC CHARACTERS 
ON THE SCREEN: 


PRINT command is used to display alphanumeric characters on the screen after 
the word PRINT. The alphanumeric characters desired to be displayed must be 


enclosed in quotation marks ("') at the beginning and the end of any string of 
characters 


PRINT "M58 BASIC" ——— tobe followed by [2] 


Mse BAS Te io appears as the result of the command 


u k sEUthe completion of command execution 


Ey the cursor appears 


2-2 DISPLAY OF NUMERIC CHARACTERS 
AND CALCULATIONS: 


PRINT command can be substituted by ?. Thus, type: 
?58*9-21 and _ and 501, which is the result 
In BASIC, the asterisk (*) and the slash (/) are ttsed to denote multiplication and 


division, respectively. In MSX-BASIC, the following Arithmetic symbols are 
used, 


Arithmetic expression evaluations 


Arithmetic 


operator 7 Gemientics Priority order 

+ Addition (X+Y) 6 
= Subtraction (X—Y) 
* Multiplication (X x Y) 3 
/ Division (X+Y) xX/¥ 
A Power (X?) x2 1 
~ Changes a sign (—X) —X 2 

| * Integer division 6.7\2.3 4 

Remainder of integer 
MOD division x MOD 10 5 
Here are some particular symbols for your programming. 
(period) Used to input a line number for the current BASIC program. 


A new line can be inserted or an error be corrected with the 
screen editor in the current program. Practicable for LIST, 
RENUM and other statements instead of a line number. 
Example: LIST. 


(minus) Used to specify a numeral value range. In LIST statement, for 
example, a command can specify its related range of lines such 
as n- thru m-line. 

Example: LIST 100-200 


(colon) Used for delimiting a multi-statement. 
Example: A=B+C: PRINT A 


. (comma) Used for delimiting two or more parameters or numeral values 
in PRINT, INPUT, DATA and other statements. 
Example: INPUT A, B, C 
DATA 8, 64, 256 


ae 


(semicolon) 


(apostrophe) 


(question 
mark) 


(quotation 
mark) 


(space) 


Used for delimiting between numerical values or character 
strings in PRINT statement, for example. 
Example: PRINT AS; B$ 


Used in place of REM statement. 
Example: ‘MUSIC 


Used in place of PRINT statement. 
Example: ?5*3.14 


Used to indicate a character string in specifying the string 
constant by putting a mark before and after. A character string 
contains up to 255 characters. 

Example: PRINT “MSX” 


Any blank spaces may be put in a statement to make the 
program more readable. No space can be, however, given in 
reserved words such as commands, statements, functions and 
system functions. Note also that spaces in the string constant 
have a meaning as characters. 

Spaces in statements are ignored when executing a command, 
but stored together when the line is transferred into the 
memory program area. So the spaces too are retrieved from 
the memory. 

A string which contains 0 characters is called a “null” string. 
Before a string variable is set to a value in the program, it is 
initialized to the null string. PRINTing a null string on the 
terminal will cause no characters to be printed, and the cursor 
will not be advanced to the next column. 

Setting a string variable to the null string can be used to free 
up the string space used by a non-null string variable. 


2-3 RE-EXECUTION OF COMMANDS: 


If required, commands can be reexecuted by moving the cursor to the beginning 
of the command and typing [_]] as follows 


7188-2°5 [J 


63 
Ok 


Bring the cursor over ? and type [e!] , then the command is reentered and re- 
executed. 


A partial or total change of input is also possible. Move the cursor to the loca- 
tion where any change is desired. If for instance 5 is desired to be replaced with 
6, just type 6 over 5. 


3 DIRECT MODE V.S. 
INDIRECT MODE 
3-1 DIRECT MODE: 


1. Indirect mode command can be typed in for an immediate ex- 
ecution as follows: 


Type in command and [J] . 


The result of executing command. 


The cursor 


None of these commands in direct mode is stored in memory and with the 
clearance of the screen by typing|SHIFT|+|CLS HOME), al! commands typed 
in are completely erased 


2. Programming and its modifications: 


Line numbers from 0 to 65529 can be programmed before executing com- 
mands using BASIC. 


Typing 10 PRINT “MSX" [J] will only store this command in RAM of 
computer but will not execute it. 


Then type: 


26 PRINT “BASIC" |) 


30? 18*8-5 [J 


Then clear the screen. 
Next type LIST .!| and the screen will display as follows: 


list 
1@ PRINT "HSK" 


26 PRINT "BASIC" 
3@ PRINT 16*#8-5 
Ok 


Since the program is stored in RAM memory of the computer, the program once 
cleared can be redisplayed time and time again, by listing, and modification of 
any part of the program can be made at will. 


3-2 INDIRECT MODE: 


By typing RUN, the operation mode is changed from direct to indirect. If either 
of the following applies, the operation mode is reverted back to direct from in- 
direct: 


1. If the execution of the program is interrupted by typing|CTRL|+/STOP|, or 


2. \f any error is contained in the program, in grammar, in calculation formula 
(a division by 0, etc.), and so on, or 


3. If the program is terminated by END command, or if the program has ex- 
hausted the line numbers. 


During the command execution, this computer will not accept any typing input, 
unless especially so specified. Type RUN and !-/| to display the following on the 
screen: 


direct mode 


execution of program 


back to direct mode 
the cursor 


Fz 


Note: 


The computer operation is controlled by an LSI called CPU (Central Processing 
Unit). The alphanumeric characters entered are memorized in the keyboard buf- 
fer. The CPU controls such input memories for display on the screen, for pro- 
gramming, and for execution of programs responding to the operator’s command 
such as typing which will execute the program loaded in the computer. If 
the command is preceded by line numbers, it is stored in memory for the in- 
direct mode operation. 


The RUN command which is entered in direct mode will execute the program 
and upon completion of its execution, or if any error occurs, the operation 
mode is reverted back to the direct mode. 


CPU takes care of both the program stored in memory and the cursor position. 
Thus by moving the cursor back and typing , the command once executed 
can be executed again. 


4 MODIFYING THE PROGRAM 


It is almost impossible to make the perfect program at the first trial. Usually the so 
called debugging process is required to correct errors in typing, in calculation for- 
mula, etc. 


4-1 ADDING A LINE: 


The program is executed in sequence of the line numbers. 


list 
14 PRINT "MNSK" 
26 PRINT "BASIC" 


38 PRINT 1@4#8-5 
Ok 


If additional command is required between line numbers, for instance to insert 
between the line numbers 20 and 30: 


PRINT "19#g-S="5 


Just type 25 ?10«8—5="; [~)| and clear the screen ([SHIFT] + (CLS HOME)) 


and then type list again. The line 25 is now inserted between the lines 20 and 30. 


4-2 REPLACING A LINE: 


If MSX of the line 10 in the program shown in 4-1 above is desired to be replaced 
with ABC, just type 10 PRINT “ABC” [J] . In BASIC, if more than one inputs 
bearing the same line number are entered by typing, the latest input prevails over 
all prior inputs: 


list 
1@ PRINT "ABC" 
206 PRINT "BASIC" 


25 PRINT “16#8-S="3 
38 FRINT 16#¢-5 
Ok 


4-3 DELETING A LINE: 


1. Any line can be deleted by just typing only the particular line number not 
required and . 


2. Any particular range of lines can be deleted by the DELETE command as 
follows: 


DELETE -20[] ----: Will delete up to line 20. 
DELETE 28-25 [4] --- witi delete from line 20 to line 25. 


Programming titbits - TO ENTER SIMILAR COMMANDS 
QUICKLY: 


1. Enter the command: KEY 10, “PRINT’+CHR$(&H22) [.] and type £10 
key and PRINT” command is entered at each touch of f10 key. 


2. Entering command by changing line numbers is also possible. 

After entering: 

10 PRINT “M", 

move the cursor to the letter ''M’’ and replace it with the letter ‘'S’’ and then 
the cursor to 10 and replace it with 20. 


16 PRINT "it" 
26 PRINT "S" 
3@ PRINT "X" 


3. Exception to line deletion: 

When auto command is used to generate line numbers automatically, and if 
the line number already entered is entered again, the asterisk (=) appears after 
that line number to show that the number previously entered is still valid. 


5 RESERVED WORDS OF BASIC 


The following are the fundamental reserved words necessary to start practicing 
the programming based on BASIC. 


5-1 RESERVED WORDS 


1. Generally speaking, entries into computer under direct mode are called com- 
mands and under indirect mode, statements. However, a clear cut distinction 
between commands and statements is not possible because some of the 
entries can be made in both direct and indirect modes. 


2. Reserved words can be entered in upper or lower case characters or any com- 
bination of upper or lower cases. For instance the PRINT command can be 
entered as Print, PRint, or pRINT but P RINT (a space between characters) 
will result in an error entry. 


Reserved Words of BASIC 
COMMANDS COMMANDS/STATEMENTS STATEMENTS FUNCTIONS 


run print IF-THEN SQR( ) 
list color FOR-NEXT INT( ) 
ABS( ) 


5-2 FUNCTIONS: 


1. If given data to work on, functions will calculate or execute operations. 
Functions are never used alone but in combination with other commands. 


INT (3.14) [J] This command is used to obtain integer of the 
number enclosed in the parentheses. 


Typing the foregoing alone will result in the Syntax error message on the 
screen. However, type PRINT INT (3.14) and the answer is 3 is given. 


2. Some of the functions are already defined by BASIC, such as ABS, INT, SIN, 
COS, PEEK, etc. while others can be defined also by the user. 


4G 


3. The user defined functions are called DEF FN. The name of the DEF FN 
can be further defined by a suffix which follows the FN, (for example, 
FNA, FNB, FNC, etc.). 


User defined function: (Example) 


Calculation formula (Example) 
Variables used 


Function name ~— 


DEF FNACA;B)=A*B-B- 16 


6 CONSTANTS AND VARIABLES: 


There are two types of calculations, 1. a calculation using constants and 2. a 
calculation using variables, as follows: 


1. PRINT 10075 
2. A=100 :B=2:C=5:PRINT A-B°C 


While the result of calculation is the same with 1. and 2., in the latter, values for 
calculation can be changed. 


INPUT A-B 
PRINT As "#"3B3 


PRIHT "=" AB 
GOTO 16 


Type run and [.J] will display ? on the screen. Type 4,5 [J] and 4*5=20 will 
then be displayed and ? will reappear showing that computer is ready for next 
assignment of command 


=| = 


6-1 STRING CONSTANTS AND VARIABLES 


In the following example, both constant and variable string characters are 
included. 


PRIWT "“fss" ---- 10MSxX isa fixed string constant. 


As=" BAS i 20 A$ is an string variable the constants 
PRINT AF which can be changed. 


String variables are expressed in two digits of alphanumeric characters, starting 
with an alphabet followed by the dollar mark ($), for example: 


H$;,eF,C$. see 
Als, B2$,C0U3$. see 


Ail$c1>, BO SCs... 


MSX-BASIC reserved words (command names, function names, etc.) or a charac- 
ter string that includes a reserved word cannot be used as a variable name. 

Only the first two characters are significant (the 1st character must be an alpha- 
betical character). 


6-2 NUMERIC CONSTANTS AND VARIABLES: 


Numeric constants and variables are simply called constants and variables in 
general. In the following program, A is a variable while 5 is a constant. 


16 INPUT A 


26 PRINT A#5 


Constants and variables take the form of Integer, Single Precision and Double 
Precision. 


1. Integers: 


Any value in the range —32768 to 32767 which is suffixed with the percen- 
tage symbol (%) is called an integer as follows 


S14 Mies es 3; 3168% .. ... 3168 


Thus A% will mean an integer variable. 
Thus, statements, A=5.14 A%=5.14, will result in A%=5. 


—12— 


2. Single Precision: 


Real quantities suffixed with ! mark are Single Precision numbers. Up to 6 
digits are valid and the 7th digit and over are truncated at the 7th digit and 
such numbers are expressed in 6 digits. 


i 100.000 (displayed on the screen as 100) 
12345678! .... 12345700 
123.45678! .... 123.45700 


A! (Single Precision Variables) 


3. Double Precision: 


Real quantities with 7 digits and over or real quantities suffixed with # mark 
are called Double Precision numbers. Up to 14 digits are valid with the 15th 
digit truncated. 


3.14159265358979323# ........ 3.1415926535898 
314159265358979323# ........ 3.1415926535898E +17 
A# (Double Precision Variables) 


Any number which is not suffixed with any of the marks, %,!, or #, is treated 
as Double Precision Variables. 


Type declaration 
Declaration by a type 


Declaration by a DEF 
declaration character statement 
Add % DEFINT Integer type 
Example: A% Example: DEFINTA 
Add ! DEFSNG Single precision 
Example: DEFSNG B 


Type declared 


Example: B! 

Add # DEFDBL Double precision 
Example: C# Example: DEFDBL C 

Add $ DEFSTR String type 
Example: D$ Example: DEFSTR D 


When a different type of type declaration character is placed for the vari- 
able name after the type declaration statement (DEFINT, etc.) was ex- 
ecuted, the type declaration character has priority. 


Type conversion of numeric constant: 


When necessary MSX-BASIC will convert a numeric constant from one type to 
another. The following rules and examples should be kept in mind. 


Binary Octal Decimal Hexadecimal 
expression expression expression expression 


&BO &01 | HT 
+2 


The decimal number 13 is expressed in MSX-BASIC for each type as follows: 
&B1101 &015 13 &HD 


44 


7 FUNDAMENTAL OPERATIONS 
IN PROGRAMMING: 


The following descriptions are important for typing inputs and for understand- 
ing the language used in programming 


7-1 AUTO COMMAND TO GENERATE LINE 
NUMBERS AUTOMATICALLY. 


1. Type AUTO [<the opening line number>] [, <incremental unit number>] : 
If no numbers are filled within the brackets [ ], AUTO command will begin 
with the line number 10, and will increase by the unit of 10 at each typing of 
f] 


2. To disengage AUTO mode, type + [STOP] or [(ETRL] +[C] 


@iCTRL] + can be used to interrupt input commands, while typing [CTRL] + 
STOP} can stop both input and execution modes of operation. 


7-2 INPUT DURING THE PROGRAM OPERATION 


Any entry during execution mode will not be accepted by the computer, with 


the exception of special commands, such as [CTRL|+{STOP], or when the pro- 
gram includes special commands and statements as follows 


1. INPUT command: 


INPUT command if included in the program will stop execution of the ope- 
ration to wait for input from the keyboard. 


INPUT B 

IF Be24 THEN GOTO 16 
C$=STRINGECBE, "a" 

LOCATE 4,CSRLIN-1LIPRINT C$ 
GOTO 16 


This program will show ? after it is executed by typing RUN to wait for 
keyboard input. Type numbers (integer) in the range O—24, and @ mark will 
be displayed on the screen in the exact number typed. INPUT C$ will mean 
that the execution of command will wait for an input of string variables 


45s 


2. INKEY$ command: 


This command in the program will permit accepting key input during the pro- 
gram operation. 

10 replaces INKEY$ with string variables A$. 20 will assume that space 
key is entered if in fact no key is pressed, 


16 AF=INKEYS 
2@ A$="" THEN 26 


38 PRINT At 
46 GOTO 18 


7-3 JUMPING OUT OF THE NORMAL 
PROGRAM SEQUENCE: 


1. GOTO command: 


This command is used to branch unconditionally out of the normal program 
sequence to a specified line number. 


If line number is an executable statement, that statement and those following 
are executed. If it is a nonexecutable statement, execution proceeds at the 
first executable statement encountered after line number. 


2. GOSUB command: 


This command is a subroutine which may be called any number of times in 
a program, and a subroutine may be called from within another subroutine. 
The RETURN statement in a subroutine causes BASIC to branch back to 
the statement following the most recent GOSUB statement. 


A subroutine may contain more than one RETURN statement, should logic 
dictate a return at different points in the subroutine. 


Subroutines may appear anywhere in the program, but it is recommended 
that the subroutine be readily distinguishable from the main routine. 


To prevent inadvertent entry into the subroutine, it may be preceded by a 
STOP, END, or GOTO statement that directs program control around the 
subroutine, 


Otherwise, a "RETURN without GOSUB” error message is issued and ex- 
ecution is terminated. 


=| 


Main routine Subroutine 


RETURN 


7-4 CONDITIONAL COMMAND: 


1. IF <expression> THEN <statement(s)> or <line number> 
[ELSE <statement(s)> or <line number>] 


2. IF <expression> GOTO <line number> 
[ELSE <statement(s)> or <line number>] 


@To make a decision regarding program flow based on the result returned by 
an expression. 


@lf the result of <expression> is true (except zero), the THEN or GOTO 
clause is executed. THEN may be followed by either a line number for 
branching or one or more statements to be executed. GOTO is always fol- 
lowed by a line number. If the result of <expression> is false (zero), the 
THEN or GOTO clause is ignored and the ELSE clause, if present, is ex- 
ecuted. Execution continues with the next executable statement. 


SExample: 


:B=2 ... A=B is false (zero) 
B=2... A=B is true (except zero) 


@iF ... THEN ...ELSE statements may be nested. Nesting is limited only by 
the length of the line. If the statement does not contain the same number of 
ELSE and THEN clauses, each ELSE is matched with the closest unmatching 
THEN. 


@lf an IF... THEN statement is followed by a line number in the direct mode, 
an “Undefined line" error results unless a statement with the specified line 
number had previously been entered in the indirect mode. 


= 


3. ON <expression> GOTO <line number> [, <line number>.. . .] 
ON <expression> GOSUB <line number> [, <line number>... .] 


@To branch to one of several specified line numbers, depending on the value 
returned when an expression is evaluated. The value of <expression> deter- 
mines which line number in the list will be used for branching. For example, 
if the value is three, the third line number in the list will be the destination of 
the branch. (If the value is a noninteger, the fractional portion is disregarded. ) 


@in the ON ...GOSUB statement, each line number in the list must be the 
first line number of a subroutine. 


@\f the value of <expression> is zero or greater than the number of items in 
the list (but less than or equal to 255), BASIC continues with the next ex- 
ecutable statement. If the value of <expression> is negative or greater than 
255, an “illegal function call” error occurs. 


14 PRINT " INPUT ABSOLUTE¢No.> " 
26 INPUT B 

36 A=ABS(B/183 

43 IF A>3 THEN 186 

56 ON A GOTO 78,30,98 

66 PRINT "LESS THAN 18":60TO 26 


76 PRINT "18 TO 19":G0TO 28 
S@ PRINT "26 TO 23":G0TO 20 
34 PRINT "38 TO 33":G0TO 26 
14@ PRINT "MORE THAN 39" 
116 GOTO 26 


~18— 


7-5 LOGICAL OR RELATIONAL OPERATOR: 


®Conditional command, IF ... THEN, is called logical or relational operator. 


®Relational operators are used to compare two values. The result of the com- 
parison is either “true’’ (—1) or “false’’ (0), This result may then be used to 
make a decision regarding program flow. 


Logical expressions 


Logical expressions perform logical operations between numeric type constants, 

variables, and functions, 

Logical operation. .... Converts data to an integer considered as 16 bit binary, 
and performs an operation for each corresponding bit. 


Logical operation Logical operation result for each bit 
x NOT X 
NOT (negation) 1 8) 
0 1 


AND (logical product) 


OR (logica! sum) 


EQV {exclusive OR negation) 


IMP (Implication) 


Relational expressions 
The value of two data are compared and the result is given as true (—1) or 


false. 
Example 
X=Y, X$=YS$ 


Relational 
operator 
X<Y, X$<Y$ 


= 
> X>Y. X$<Y$ 


Semantics 


Equal 
Smaller 
Larger 


Not equal X<>Y, X$><Y$ 
Srller oF oa 


7-6 CONDITIONAL LOOP COMMAND: 
1. FOR .. . NEXT command: 


Larger or equal 


For <variable> = x to y [STEP z] 
NEXT [<variable>] [,<variable>.. .] 


Note: 


<Variable> can be integer, single-precision or double-precision, where x, y, 2, 
are numeric expressions. 


@To allow a series of instructions to be performed in a loop a given number of 
items: 


@<Variable> is used as a counter. The first numeric expression (x) is the 
initial value of the counter. The second numeric expression (y) is the final 
value of the counter. The program lines following the FOR statement are 
executed until the NEXT statement is encountered. Then the counter is 
incremented by the amount specified by STEP. A check is performed to see if 
the value of the counter is now greater than the final value (y). 
lf it is not greater, BASIC branches back to the statement after the FOR 
statement and the process is repeated. If it is greater, execution continues 
with the statement following the NEXT statement. This isa FOR... NEXT 
loop. If STEP is not specified, the increment is assumed to be one, 


@lf step is negative, the final value of the counter is set to be less than the 
initial value. The counter is decremented each time through the loop, and 
the loop is executed until the counter is less than the final value. 


@The body of the loop is executed one time at least if the initial value of the 
loop times the sign of the step exceeds the final value times the sign of the 
step. 


@FOR ...NEXT loop may be nested, that is, a FOR... NEXT loop may be 
placed within the context of another FOR ...NEXT loop. When loops are 
nested, each loop must have a unique variable name as its counter. The 
NEXT statement for the inside loop must appear before that for the outside 
loop. If nested loops have the same end point, a single NEXT statement may 
be used for all of ther. Such nesting of FOR ... NEXT loops is limited only 
by available memory. 


@The variable(s) in the NEXT statement may be omitted, in which case the 
NEXT statement will match the most recent FOR statement. If a NEXT 
statement is encountered before its corresponding FOR statement, a “NEXT 
without FOR" error message is issued and execution is terminated. 


FOR N=&H4@ TO &HSF 
PRINT CHRE¢19+CHRSCNDS" "5 
NEXT WN 


FOR K=&H20 TO &HFF 
PRINT CHRE{K93" "3 
HEXT Kk 


2. IF <expression> GOTO <statement(s)>; <line number> used as a 
loop command: 


A combination of IF ... GOTO command with variables can repeat the com- 
mand within the specified line numbers. To use this command, the following 
two alternatives are available. Both of these operations however are almost 
identical. 


Preceding IF Succeeding IF 
run |.J 
run le 
GOTO <oro> 
END 
END 


-21- 


@Preceding IF will determine whether to execute the program by IF command, 
and if executed, GOTO statement will skip line numbers as programmed. 


®@Succeeding IF will skip line numbers by conditional GOTO statement based 
on judgement made by IF statement, after once running the program. 


=Example 


H=1 
IF No15 GOTO 7b 
R=RHOC1 9436 


VERNDC 1) #21 

LOCATE #,Y:PRINT "a" 
N=N+1:G070 26 

END 


Note: Programming Tibits — Multiple statements 
@\n each line number in the BASIC program, (not the line displayed on the 
screen), program of upto 255 characters can be entered. The total line num- 
bers can be reduced by packing as much information as possible per line 
number. 


®Command or statement within the line number can be segregated by colon (:). 
The program is a sample of multiple statement: 


16 COLOR 15,1,1:SCREEN 3:FOR R=1 TO 765% 
1=-1L#R#COSCRISKZ=125-H1EVLI=ReSINCRIEY2=1 
BO-VLISCSRNDC-TIMES #13+2°PSETCK2,¥2),08PS 
ETCHI+125,¥14166>,C2PLAY "N=R3 "NEAT RIF 


OR N= TO 127:V=191/255#XtLINECK,¥)-¢255 
“As 191-9, RNDC-TIME2#13+2,BsNEXT Xt COLOR 
15.4,72END 


—22— 


7-7 RENUM COMMAND (RENUMBERING 
LINE NUMBERS): 


@Since it is not infrequent that programs are modified and edited several times 
before they are completed, sometimes renumbering the line numbers becomes 
necessary as follows: 


RENUM[[<new string line number>] [. [<old string line number>] 
[.<increment>] ] 


@<new string line number> is the first line number to be used in the new 
sequence. The default is 10. <old string line number> is the line in the 
current program where renumbering is to begin. The default is the first line 
of the program, <increment> is the increment to be used in the new sequ- 
ence. The default is 10. 


@®RENUM also changes all line number references following GOTO, GOSUB, 
THEN, ELSE, ON..GOTO, ON..GOSUB and ERL statements to reflect 
the new line numbers. If a inonexistent line number appears after one of 
these statements, the error message ‘Undefined line nnnn in mmmm' is 
printed. The incorrect line number reference (nnnn) is not changed by 
RENUM, but line number mmmm may be changed. 


Note: 


RENUM cannot be used to change the order of program lines (for example, 
RENUM 15, 30 when the program has three lines numbered 10, 20 and 30) 
or to create line numbers greater than 65529. An “Illegal function call’’ 
error will result. 
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7-8 REM (REMARK) — INSERTION OF 
EXPLANATORY REMARKS: 


@\nsertions of explanatory remarks on the program are helpful for long pro- 
grams or to read programs prepared by others. The explanatory remarks can 
be entered by typing REM, or apostrophe mark (') after line number. See line 
number 20 and 50 of the sample given below: 


_ 


REHM samrele exrFlanatory remarks 
*to enter statement 

INPUT "A+B...A"3A 

LHP owas O° EE 

*statement 

PRINT As"+"SB3"="SA+E 

ENG 


3 
4 
ss) 


Geeoras 


—~j co 


@REM or (‘) cannot be used in a DATA statement as it would be considered 
legal data. 
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1 SCREEN CONFIGURATION 
1-1 SCREEN CONFIGURATION 


The display screen configuration for MSX-BASIC is as shown below. 


Foreground 


Sprite plane (32 planes from O to 31) 


1. Text mode and graphic mode 


The text mode displays characters (alphanumeric characters), and the graphic 
mode displays graphics (dots, lines, circles, etc.). MSX-BASIC includes two 
text modes and two graphic modes that are selected by a SCREEN statement: 


The modes selected by a SCREEN statement are as follows. 


SCREEN Sprite hc 
statement Mode plane Characteristics 
SCREEN O 40 characters max. Can‘t be | Width per character is 6 
horizontal, 24 used dots. Since the width of 
lines vertical. a part of graphic char- 
acters is 8 dots, they 
cannot be completely 
displayed. 
} Text -—— — + t —____ = 
SCREEN 1 32 characters max. Can be | Width per character is 8 
horizontal, 24 used dots. Since most char- 
lines vertical. | acters use only 6 dots, 
the display characters 
are read more easily 
compared to SCREEN 
S 4 ———————————— 0. Se 
SCREEN 2 256 x 192 dots high} Can be | Graphics are drawn 
| ; resolution mode used with 1 dot units. 
. + Graphic + — ——$___— 
SCREEN 3 256 x 192 dots Can be | Graphics are drawn 
multi color mode used with block units of 4 x 
[Se l _ : it | 4 dots. eates 
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zs 


The foreground, background, and border area are used in any mode. With 
characters or graphics displayed in the foreground, only color can be changed 
for the background and border area. 


Also, the sprite planes can be used in addition to the above in modes other 
than the SCREEN O mode. A sprite plane is a plane on which a dynamic 
picture can be displayed by using freely defined sprite patterns which will 
be explained in the “How to use the sprite pattern” section. 

Color specification 


A COLOR statement specifys the colors of the foreground, background, and 
border area. 


COLOR foreground color, background color, border area color 


Both characters and graphics are displayed with the color specified for the 
foreground color, unless specifically specified. 


Also, in the SCREEN O mode, the color of the border area is always the 
same as that of the background. 


1-2 HIGH RESOLUTION GRAPHICS... 


SCREEN 2 MODE 


Graphics can be drawn with the following commands in a graphic mode. 


PSET,. PRESET « a: es wae ow ies 5 Marks a dot or erases it. 

TIMES is eke os RS Oe mares BY Draws a Straight line or square. 
PE. aie ction ya wae Riacewmee ang Draws a circle. 

CANIN ces sts. Secret ee Ses os aes Colors 

DRAW 2: os ecteee me Bees om 2 Draws arbitrary graphics. 


When these commands are used, screen coordinates are set to specify the screen 
location. 


0123 255 In the high resolution graphic mode, 
the location and color can be speci- 
fied for each dot with 256 dots ar- 
ranged vertically and 192 arranged 
horizontally as shown in the above 
figure. 


However, if each specified color is 

restricted to 8 horizontal dots, only 

1 color can be specified, and the 
191 color specified last is valid. 


ay y fo 


1@ SCREEN 2 
26 LINE (9,50)-€14,50),15 


36 LINE (12,469-(€12,60),1 
46 GOTO 48 


In the above program, with hori- 
zontal block coordinates from 8 to 
15, although the color was specified 
as white, the straight line drawn by 
line 20 is displayed as black because 
the black line drawn next overlaps 
this line. 

The specification of white becomes 
valid when the LINE statement in 
line 20 is changed as follows. 


This allows a maximum horizontal line to be drawn in the block of 8 
dots. 


1-3 MULTI COLOR GRAPHICS... 
SCREEN 3 MODE 


Graphics can also be drawn in the SCREEN 3 mode by using a graphic command 
such as a PSET or LINE statement. Also, the location can be specified by utiliz- 
ing O—255 horizontal and O—191 vertical coordinates. The unit for drawing 
graphics is a 4 x 4 dot block. 


0123456 7 8910111213145 


PSETC12,4),1 
PSET(14,5),1 
FSETC15,7)51 


NQOS WHO 


og. 


For example, since the above statements specify 1 dot in the same block, the 
part of the @ part of the above figure is colored black by using any of them. 


LINE(17,5)-¢€138,11@) 


This program draws a rough line to connect blocks that include (17.5) and (130, 
110), or in other words to connect Fig. A and Fig. B. 


16 19 128 131 
4 108 


Fig. A Fig. B 


STEP SPECIFICATION 


To specify coordinates (X, Y), the STEP (X, Y) specification can be performed 
by CIRCLE, LINE, PAINT, PSET, PRESET, and PUT SPRITE commands. 

When these graphic commands are executed, the dot specified last is memorized 
by MSX-BASIC. After this, when STEP (X,Y) is specified next, the location of 
(X, Y) is determined on a new coordinate system with a dot specified last as the 
origin (0, 0). However, if STEP is omitted, the location can always be specified 
on the ordinary coordinate system using the extreme top left of the screen as the 
origin. 


= Example 1 


160 SCREEN 2 
26 PSET (58,58) 


34 LINE STEP(C6@,-469-(158; 168) 
49 GOTO 46 


In this program, the coordinates 
(50, 50) specified when the PSET 
statement was executed are memo- 
rized in line 20 then the program 
advances to line 30. Since STEP (60, 
—40) is used as a specification for the 
LINE statement starting point, the 
new starting point is a location that 
is 60 toward X and —40 toward Y 
with (50, 50) as a new origin. 


(150, 100) 


= 


= Example 2 


SCREEN 2 
FOR I=36 TG 246 STEP 26 
LINE ¢120@,165-¢1,.1508) 


CIRCLE STEP‘. 289.26 
CLS 
HEXT I 


In this program, although the 
LINE statement end point co- 
ordinates in line 30 are changed 
by the repetition of a FOR-— 
NEXT loop, the center of the 
circle is specified by STEP 
(0, 20) in the CIRCLE statement 
of line 40, and the center of the 
circle is always determined to be 
si a certain distance from the 
STEP (0, 20) origin which is the end point of 
a straight line. 


3 HOW TO USE THE SPRITE 
PATTERN 


In MSX-BASIC, a pattern (called a sprite pattern) with a freely defined format is 
displayed as one of 32 sprite planes and can be moved. 


3-1 SPRITE PATTERNS 


A sprite pattern consists of 8 x 8 or 16 x 16 dots for which two different sizes 
(magnified or unmagnified) can be selected. The magnified size is twice as big as 
the unmagnified size both horizontally and vertically. 


on™ 


8 x 8 dots unmagnified 


CITT 


16 x 16 dots unmagnified 


8 x 8 dots magnified 


16 x 16 dots magnified 


The size of a sprite pattern is Paainnienl Sprite size 
determined by a SCREEN 8) 8 x 8 dots unmagnified 


1 8 x 8 dots magnified 
: | 16 ; ifi 
of a SCREEN statement selects | 2 | 16 x 16 dots unmagnified 


the sprite size 


SCREEN 2.2 | 


This statement specifies that a 16 x 16 unmagnified sprite is used in the high 
resolution graphic mode 


statement. The 2nd parameter 


16 x 16 dots magnified 


The sprite size displayed on all sprite planes remains 
constant once the sprite size is specified by a SCREEN statement 


3-2 SPRITE PATTERN DEFINITION 


When an 8 x 8 dot pattern is defined, the pattern is first 
separated by 8 lines horizontally. For example, an arrow 
pattern is defined as shown in the following figure 


> | 


When this pattern is separated into 8 horizontal lines, it is divided into small 
patterns that consist of 8 dots. 


aoe 6B 
[| a | 


aoe. 6B 
Ll | ma [| 
Ll | Mam [| [| 
ae 6 


Next the pattern in each line is arranged with 1 used to mark a dot and O used 
to indicate an unmarked dot which results in a binary number. For example, 
the top line is 00011000, and the next line is 00111100. 


CTT ME TT) — = [ofololsTiTofofo} 
(MT) > = ofol PsT fof} 


The binary numerals realized as mentioned above are converted to 
hexadecimal (or decimal). 


For the top line, 
00011000 (binary) = 18 (hexadecimal) or 24 (decimal). 


For the second line, 
00111100 (binary) = 3C (hexadecimal) or 60 (decimal). 


It is easier for the user who is unaccustomed to convert binary 
to hexadecimal to divide the 8 dot pattern into 4 dots on the 
left and 4 dots on the right to convert to one hexadecimal 
digit (O—F) by referring to the following table 


9 


Pattern Hexadecimal Pattern 


0 


With the] | EN [ |} pattern, left 4 dots is(_[_] I and right 4 dots 
| See 


Therefore, they are converted to hexadecimal 18 based on the above table. 


The character, for which hexadecimal (or decimal) is the character code, is 
obtained by using the CHR$ function. The definition of the sprite pattern 
explained above is arranged as follows. 


CHRS$(&H18) 
CHRS$(&H3C) 
CHRS(&H7E) 


Pattern to be defined CHRS$(&HFF) 
CHRS$(&H18) 
CHR$(&H18) 
CHRS$(&H18) 


CHR$(&H18) 


In regard to the 8 x 8 dot sprite pattern, the character data obtained as shown 
above is added sequentially from ti.2 top and is assigned to the SPRITE$ variable 
as a character string which defines the sprite pattern. For the arrow pattern in 
the above example, it is defined as follows 


SPRITE#« 1)=CHR$¢&H1S9+CHRFC&HSCI+CHRS CEH 
PE +CHRS¢ SHEFF O+CHRECEH1S8)+CHRFCEHI89+CHR 


$(&H13)+CHRE(C&H1S) 


me we 


The number of the defined sprite pattern is 1 and is indicated by the numeral 1 
inside the parentheses of SPRITE$ (1). 


A 16 x 16 dot sprite pattern can be defined with the same procedure. However, 
a 16 x 16 dot sprite pattern is considered to be a collection of four 8 x 8 dot 
sprite patterns, and these four patterns are defined after putting them together 
in the sequence shown below. 


AS=CHRS (&HO) +CHRS(&HO) +CHRS(&H1S) +CHRSC&HSC) 
+CHRS(&H3C) +CHRS(uHI 8) +CHRS(&HO4) +CHRS(&H22) 
ES=CHRS(&HIA)+CHRS(&HOS) + CHRS(&HOF) + 
CHRS<&HOF) +CHRS( &HB 7) +CHRS¢(&HO7) +CHRS(&HOS) 
*+CHRS(&HOS) 

CB=CHRS(%:HOC)+CHRE(&HIE) +CHRS(&HSS)+ 
CHRS(&HSS) +CHRS(&HIE) +CHRE<&H2C) +CHRE(&H28D 
+CHRS(&HSC) 

OS=CHRS (&HSS) +CHRE(&HAG ) +CHRE (&HFO) + 
CHRS(&HFO) +CHRS(&HEO)+CHRS(&HEO)+CHRS(&HCO? | 
+CHRS<(&HCO) 
SPRITES( 2) =AS+E8+CE+DS 


3-3 NUMBER OF SPRITE PATTERNS THAT CAN 
BE DEFINED 


The numbers of 8 x 8 dot sprite patterns are from 0 to 255, and those of 16x16 
dot sprite patterns are from O to 63. In other words, up to 256 8x8 dot sprite 
patterns can be defined, and up to 64 16x16 dot sprite patterns can be defined. 
(However, this is sometimes restricted depending on the memory capacity.) 


3-4 SPRITE PATTERN DISPLAY 


A PUT SPRITE statement is used to display a defined sprite pattern on a sprite 
plane. 


PUT SPRITE sprite plane number, (X-coordinate, Y-coordinate), color code, 
sprite pattern number 


To display a sprite pattern defined by the above at location (120, 80) of sprite 
plane O with green (color code 2), the program is as follows. 
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PUT SPRITE @,¢128.88),2,1 


The specified display location is a dot on the left top of the sprite pattern frame. 
The X, Y-coordinates are specified using a coordinate system with (0, —1) on 
the graphic screen as the origin (0, 0). 


(120, 80) 


Sprite plane O 


Sprite pattern 1 


PUT SPRITE 0, (120, 80), 2,1 


SPRITE PATTERN DISPLAY RULES 


@Only one sprite pattern can be displayed on one sprite plane. 


@When sprite patterns overlap on different sprite planes, the sprite pattern on 
the sprite plane at the back (larger number) is hidden by the sprite pattern in 
front. 


@®When five or more sprite patterns are arranged horizontally , up to four sprite 
patterns with a higher priority (on sprite planes with smaller numbers) are 
displayed. 


®@®When the display location specification is omitted, it is considered that the 
location has been specified by a previous graphic instruction. 


@®When the color code is omitted, it is considered that the foreground color has 
been specified. 


@When a sprite pattern number is omitted, it is considered that the same 
number as the sprite plane number has been specified. 


3-5 TO MOVE A SPRITE PATTERN 


To move a sprite pattern, replace the X and Y-coordinates of the display loca- 
tion specified by a PUT SPRITE statement with a variable, then execute the 
PUT SPRITE statement repeatedly by changing the value of the variable. Since 
the previous sprite pattern on a sprite plane disappears when a PUT SPRITE 
statement has been executed once, it is unnecessary to erase it in a program. 
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Also, since a pattern can be moved in 1 dot units, the movement is smooth. 


In the following program, a UFO-shaped sprite pattern files about on the screen 
by changing its direction. 


1@ SCREEN 2 

2H SPRITES(G)=CHRS(ZHSCI+CHRSCRH7E D+CHRS 
€SHSLI+CHRECEHELI+CHRSCEHFFO+CHRECEHPE D+ 
CHREC&H249+CHRFCEH42 

36 4=180:Y=188 

48 S=INTCRHNDC1?*88) Determines the movement distance. 
56 D=INTCRHDC1)*4> 

68 IF D=@ THEN UX=8:Ui=-1 

76 IF D=1 THEN Vk=1:UY=68 ; bo 

ae IF p=? THEN WX=0:UY=1 Determines the direction, 
96 IF D=3 THEN UX=-1:UY=8 

146 FOR I=6 TO 5S 

116 PUT SPRITE 6,¢%,4),1,6 

126 KEK+UXs VEV4UY Moves the sprite. 
130 IF %>24@ OR KX<@ THEN Vaa-UK 

14@ IF ¥Y>175 OR Yée THEN VY=-UY 

158 WEXT I 

166 GOTO 46 


4 MUSIC PERFORMANCE 


MSX-BASIC is provided with two music performance commands which are 
PLAY and SOUND. PLAY is a command that performs as specified by a sub- 
command using the LS| that controls pitch, rhythm, and timbre. Sound is out- 
put by writing several different data items into the LSI register. Specified data 
can be written directly to the LSI register by a SOUND statement. Therefore, a 
program that directly controls the sound with a SOUND statement can be 
prepared by knowing the function of the LSI sound register and the data to be 
written in. 


4-1 CONTROL OF VOLUME VARIATIONS WITH A 
PLAY STATEMENT 


Although the utilization of the PLAY statement is covered in the Chapter 3 
PLAY section, the S subcommand and M subcommand can be explained as fol- 
lows. 
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PLAY "CDEFG" 


Execute @ first and @) next in BASIC, and compare these two statements which 
have the same timbre. 


When you execute 


PLAY "SSM9GGCDEFG" 


it sounds as if a piano is being continuously played at high speed. 
Sn — Subcommand that selects the volume variation pattern. 
Mn — Subcommand that determines the cycle of the pattern selected by Sn. 


The initial values of Sn and Mn are S13 and M255 respectively. A different 
timbre can be generated by changing the value of n for Sn and Mn. 


Pattern and cycle combinations 


There are 8 patterns that can be selected by the S subcommand as shown in the 
table on page117. The cycle becomes shorter as the value of n is minimized by 
the M subcommand. (In other words, the pattern repetition number in a certain 
period of time becomes larger.) 

This can be proved by executing the following statement. 


PLAY “SSHBBBCDEFG" 


Let's listen to the following two statements and compare them. 


PLAY "SIBNSBGCDEFG" 


PLAY “SBM IGGCDEFS" 


Now the difference in the patterns specified by the S subcommand is clear. 
However, if the value of n becomes too large in the M subcommand, the cycle 
becomes too long. Therefore, sometimes the difference is not clear. 


PLAY "S8M6GeaCDEFG" 
PLAY "S1S8MEGGGCDEFS" 


When these two statements are executed, they both sound the same because the 
pattern was stretched horizontally (period) too long, and when the scale is 
played, the matching parts of different patterns are only used. 


= 


S8M6000 


=. 
aaa 

~ 

~ 
~ 
= 
~ 

~ 


r~ 
Pattern S8 1 = 
av ! ae: 
rae H 
' 
1 
1 


Part actually played 


ttern S10 
S10M6000 


Part actually played 


Since the length of the part actually played in the above figures is changed by 
the L subcommand specification, many enjoyable music performance programs 
can be prepared by skillfully selecting the right combinations. 


4-2 SOUND AND NOISE WITH A SOUND 
STATEMENT 


SOUND is a command that generates arbitrary sound or noise by writing data to 
a sound LSI register called a PSG (Programmable Sound Generator). The PSG is 
provided with 3 channels that generate sound (with a certain frequency). Noise 
can also be applied to all these channels. So the generation of triple chords and 
noise is possible. The PSG is provided with 16 registers which have different 
functions. 


Function 
~ Determines the frequency of channel A. 
Determines the frequency of channel B. 
Determines the frequency of channel C. 
Determines the noise frequency. 
Selects a channel. 

Determines the volume of channel A. 
Determines the volume of channel B. 
Determines the volume of channel C. 


Determines the cycle of the volume 
variation pattern. 


Selects the volume variation pattern: 


Register No, 
C- 


(Registers 14 and 15 have no 
relationship with the musical 
performance.) 
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Sound frequency determination 


The frequencies generated by the 3 different channels are determined by using 6 
registers from O to 5. Data written in a register can be obtained with the follow- 
ing expression. 

1789772.5 (Hz) 


= 256 x (register 1,3,5 data )+(register 0, 2, 4 data) 
16x (output frequency (Hz)) 


For example, when 300 Hz sound is to be generated from channel A, the fol- 
lowing expression is realized. 


1789772.5 


——_—— +373= + 
Tex300 7 373 = 256x14117 


Therefore, write 117 to register 0, and 1 to register 1. 
The actual statements are as follows. 


SOUND @,117 
SOUND 1,1 


In the case of channel B, since register 2 and 3 are used instead of register 0 and 
1, the statements are as follows. 


SOUND 2,117 
SOUND 3,1 


Noise frequency determination 


Date from 0 to 31 can be written in register 6 which determines the noise (zoo 
sound) frequency. The following relational expression is realized between the 
data and frequency. 


1789772.5 (Hz) 


Data value = ———— 
16 x noise frequency (Hz) 


For example, when data 15 is written to register 6, 


_ 1789772.5 


9 755 7457 


Therefore, the noise frequency is about 7457 Hz. 


4g. 


Channel specification 


The channel used is determined by the data written in register 7. 
Channel Channel Channel Channel! Channel Channel 
Cc B A G B A 
2.) 8 7 2 


Add the numeric values that correspond to the channel used based on the above 
table and subtract the result from 255 to obtain the data to be written. 


For example, when sound is only to be generated from channels A and B, and 
sound and noise from channel C, the following expression is realized in which 
216 is the data to be written. 


63 — (32+4+2+1)=24 


Sound generation after volume determination 


Write data that determines the volume of channels A, B, and C to register 8, 9, 
and 10 respectively. Data from O to 15 can be written with 15 as the maximum 
volume. 


The conditions required to generate sound are as mentioned above. 
The following program generates three different sound pitches from channel A, 
B, and C. 


Sault C ‘i Channel A frequency as 200 Hz. 


Sa : Channel B frequency as 800 Hz. 


SOUND 4,56 


Channel C frequency as 2000 Hz. 


SOUND 5,8 


SOUND 7s 56 Specifies the sound output from channels 


SOUND 8,9 A, B, and C. 
396 SOUND 9,16 Determines the volume of each channel and 


166 SOUHD 16,11 generates the sound, 


When the volume of each channel is changed in lines 80, 90, and 100 in this 
program, the sound output from each channel can be distinguished. 
Also, when the program is executed once, the sound keeps generating. 


Press the[CTRL]key and[STOP]key simultaneously to stop this. 
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Add: 


65 SOUND 6,31 (Determines the noise frequency.) 


to this program and modify line 70 as follows. 


3 (Outputs sound and noise from channel A 
?7@ SOUND 7,48 and sound from channel B and C.) 


Now sound mixed with noise is generated. 


Sound effect generation by volume variation patterns 


Functions that are the same as the S subcommand and M subcommand of a 
PLAY statement can be performed with a SOUND statement. Volume variation 
patterns are determined by data written to register 13, which is the same as the 
n specification of a PLAY statement S subcommand (Sn). 


See the table on page117 for then values of corresponding patterns. 


The cycle of a volume variation pattern is determined by data written to register 
11 and 12 for which the following expression is realized. 


1789772.5 (Hz) 


—————————- = 256 x (data in register 12) + (data in register 11). 

256 x cycle (Hz) ei 7” 
For example, when the cycle is set as 10 Hz, write 187 to register 11 and 2 to 
register 12 based on the following expression. 


1789772.5 


+ 699 = 256 x 2+ 187 

256x10 * 

Set 16 as the volume of the channel in which the pattern specified above is to be 
used. For example, when the volume variation is to be applied to channel C, the 
statement is as follows. 


SOUND 16,16 


Many different sound effects can be generated by applying the volume variation 
pattern mentioned above to the noise, and by mixing the sound (tone) with a 
very high frequency and sound with a low frequency to generate a metallic 
sound or humming. 


The following program generates the sound of a steam locomotive by peri- 
odically changing the noise volume. 
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FOR I=6 TO 13 
READ J 

SOUHD I,J] 
NEXT 


DATA : s2-+----------- Noise frequency 

DATA Generates noise with channel A, B, and C. 
DATA 16,16, 16----- Changes the volume of channel A, B, and C. 
DATA Volume variation cycle 12 Hz. 

CATA Volume variation pattern 14. 


5 FILE PROCESSING 
5-1 FILES AND FILE DEVICES 


Sometimes program data provided in a program as a package is exchanged be- 
tween a computer and equipment connected to a computer. 


For example, lets consider that you keep a diary. There are several bookshelves 
in your room and a notebook entitled ‘diary’ is on one of the book shelves. 
When you read your diary or write in it, first you got to the bookshelf of the 
subject and remove the notebook entitled “diary”. 


When this is applied to a computer, you are the computer and the contents of 
the diary is a program or data. The notebook where the program or data is rec- 
orded is called a file as far as computer terminology is concerned. The “‘diary”’ 
title on the notebook is the name given to a file and is a file name. The book- 
shelves are equivalent to connected equipment. If the wrong equipment is 
specified, the subject file cannot be found, 


MSX-BASIC commands have been prepared to allow a file to be exchanged 
between a computer and four different kinds of connected equipment. The 
four different kinds of equipment are called basic file divices. The relationship 
between a basic file device and a computer is as shown in the following figure. 
There are two different file devices with one that only provides output to a file 
and another that provides both input and output based on the computer. 
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@ Text mode screen 
@ Graphic mode screen 


© Cassette 
tape recorder 


File Input/Output with a file can only be performed with a cassette tape re- 
corder among the basic file devices of MSX-BASIC as shown in the above figure. 
Also, the screen of the monitor TV includes a text mode screen and a graphic 
mode screen. 


Device names 


When file exchantes are made with each file device in MSX-BASIC, a command 
is provided that specifies the file device used. At that time, the device name 
determined by MSX-BASIC is used. 


File device Device name 
___ Cassette tape recorder CAS: 
Text mode screen CAT: 
Graphic mode screen GRP: 
Printer | LPT: 
File name 


A file must have a name with a character string that has up to 6 characters 
starting with an alphabetical character. lf 7 or more characters are specified, the 
7th character and after are ignored. 


Although a file name can be omitted, it is recommended that a file name be used 
to distinguish one file from another when cassette tape Input/Output is per- 
formed. 


5-2 PROGRAM FILES 


The following commands save a BASIC program to file, load it from a file, or 
combine them. 


CSAVE;GEOAD: oe iis. 6G bm oh hae 8 We Cassette tape recorder dedicated. 
SAVE, LOAD, BSAVE, BLOAD, MERGE .. Device can be specified. 
When a program in memory is saved on cassette tape, execute: 
CSAVE “PROG1” 
ee eel 
File name 
or SAVE " CAS: PROG1” 
LW SY 


Device name _ File name 


However, a program is saved with an intermediate language format when CSAVE 
is used, and with an ASCII format when SAVE is used. 


A program saved by CSAVE can be loaded by using a CLOAD statement by 
specifying the same file name. Also, a program saved by a SAVE statement is 
loaded by a LOAD statement. Besides this, a program can be combined with 
another program that exists in memory by using a MERGE statement. However, 
this cannot be performed for a program saved by a CSAVE statement. 


Since LOAD and MERGE statements are used to input a program from a file, 
only CAS: can be specified for a basic device. Also, if a SAVE statement is 
executed for the CRT: the result is the same as LIST execution. If a SAVE 
statement is executed for LPT:, the result is the same as LLIST execution. 


5-3 DATA FILES 


When data to be processed in a BASIC program is exchanged with a device, the 
concept of a file is utilized. 


The following commands are used for data file Input/Output. 


OPEN Opens a file. 

PRINT# 0 g fi 
PRINT# USING utputs data to a file. 
INPUT# : 
LINE INPUT# Inputs data from a file. 
CLOSE Closes a file. 
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5-4 CASSETTE TAPE FILE OPERATION 


Output to a file (Write-in) 
File data output procedures are roughly as follows. 
1. Open a file with an OPEN statement. 


2. Write data to the file with a PRINT# statement. 
3. Close the file with a CLOSE statement. 


The format of an OPEN statement is as follows when data is output. 
OPEN “‘device name [file name] FOR OUTPUT AS [#] file number 

When this is executed, the set up of data output to a specified device with a 
specified file name is completed for a file. When file Input/Output is performed, 
the computer inputs or outputs data after storing it. The area prepared in mem- 
ory for storing data is called a buffer. Up to 16 buffers can be prepared in MSX- 
BASIC. The file number specified by an OPEN statement is a buffer that is used 
from among 16 buffers, in which only 1 is specified initially. 


After a file is opened by an OPEN statement, data is actually output by a 
PRINT# statement. 


PRINT# file number, expression [separator expression] -------- 
The same file number as that specified by the OPEN statement is specified. 
When data is output to a file with a PRINT# statement, a return code (RHOD) 


and a line feed code (&HOA) are automatically written next to data. When the 
data is read, these two codes indicate the punctuation of data. 


When the data is string type, insert “,”” between each data if several data are out- 
put with one PRINT# statement. 


For example, make a statement as follows: 
PRINT# 1, AS; ’,”; BS 
The comma also indicates the punctuation and the data A$ and BS are handled 
as two separate data when they are input form the file. 
When the data is numeric type, each data is automatically punctuated. 


After data is output, the file is closed by a CLOSE statement. 


CLOSE [#] file number 
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After this, since the relationship between the file number and the file is released, 
another file can be opened with the same file number. 


® Program example 


16 DIM A$C1,3) 

26 OPEN "CAS:DATA" FOR OUTPUT AS #1 
28 FOR I=@ TO 1 

46 FOR J=@ TO 3 

[8 READ ASCI, J) 

60 PRINT #1,A#¢1,J93","5 


76 NEXT J 

SH NEXT I 

36 CLOSE #1 

196 DATA JAPAN, ENGLAND, FRANCE,U.S.A 
116 DATA TOKYO,LONDON.PARIS,NEW YORK 


When this program is executed, the string type data “JAPAN”, Comma (,), 
“ENGLAND” and so forth are sequentially written to cassette tape. The data is 
actually written as follows. 


JAPAN, ENGLAND, FRANCE,.U.S.A»TOKYO,LONDON: 


PARIS,NEW YORK, 


In line 60, a comma is inserted between data which indicates the punctuation 
of data so that the data can be distinguished from other data when data is in- 
put by an INPUT# statement. 


File input (Read-out) 

The procedure for data input from a file is as follows. 

1. Open a file with an OPEN statement. 

2. Read out data from the file with an INPUT# statement or LINE INPUT# 
statement (Assigns input data to a variable). 

3. Close the file with a CLOSE statement, 


The format of an OPEN statement when data is input from a file is as follows. 


OPEN “‘device name [file name] '" FOR INPUT AS [#] file number 
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The set up for data input from a file is prepared by this. Only file No. 1 can be 
specified initially. 


After a file is opened, data is read-out by an INPUT# statement. 
Data that is read-out when an INPUT# statement is used is as shown in the 
following table. 


For numeric type data For string type data 


Space, return code, line Ignored Ignored 
feed code before data. : 

Punctuation for data, or Space, comma, return Comma, return code, 
when data is punctuated. code, line feed code line feed code. For 


255 character input. 
\terns inside’ “ are 
input as one data, 


When data is inside” 


Also, a LINE INPUT# statement is only used for character data read-out in 
which input is performed with a return code as only punctuation for data. 


After data input has been terminated, the file is closed by a CLOSE statement to 
separate the relationship between the file number and file. 


= Program example 


186 DIM AS¢1,3> 

26 OPEN "CASSDATA" FOR INPUT AS 
36 FOR I=8@ TO 1 

40 FOR J=6 TO 3 

S6 INPUT #1,;A#¢1,]3 


BH HEAT J 

?@ NEXT I 

8G CLOSE #1 

96 FOR J=8 TOS 

14@ PRINT A€(G,73.HFC1,I9 
116 NEXT J 


This program is used to read-out a file on cassette tape, named “DATA”, pre- 
pared in the previous program (lines 20 — 80) and to display the content on the 
screen (lines 90 — 110). In line 50, data is continuously assigned to the A$ 
(1, J) array variable. 


16 OPEN "CAS:DATA" FOR INFUT AS #1 
29 INPUT #1,A% 


3@ PRINT AF 
46 GOTO 26 


What happens if the file called "DATA" is input by using the program above? 
JAPAN, ENGLAND ... are continuously assigned to the A$ character variable 
and are displayed on the screen. However, after the last data, NEW YORK, has 
been input, the program tries to input continuously data. When this occurs 
although the file has ended, an "Input past end’’ error occurs. To prevent this, 
the EOF function is used. 


16 OPEN "CHS!DATA" FOR INPUT AS #1 


15 IF EQF¢1)=-1 THEN GOTO Sa@ 
20 INPUT #1,A4 


38 PRINT A$ 
46 60T0 15 
S@ CLOSE #1 


The EOF (file number) function gives — 1 when the last file data has been read 
out. In this program, if data remains or not is checked every time data is input 
when this function is used. 


5-5 DISPLAYING CHARACTERS ON THE 
GRAPHIC SCREEN 


When SCREEN 2 or SCREEN 3 is specified by a SCREEN statement, the screen 
enters the graphic mode which does not allow characters to be displayed by a 
PRINT statement. 


To display characters on the graphic mode screen, a method is used in which the 


graphic mode screen is considered to be a file device and characters to be dis- 
played are output as a file data. 
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16 SCREEN 2 
26 OPEN "GRP?" FOR OUTPUT AS #1 


3@ PRINT #1,"How do you do?" 
46 GOTO 46 


When this program is executed, the screen is converted to the graphic mode and 
“How do you do?” is displayed. 


Execute one of the graphic instructions just before to specify the display loca- 
tion. After this, the location specified by the instruction last (256 horizontal, 
192 vertical dots) is the top left corner of an 8 x 6 dot frame that holds the first 
character of the output character string. 


1@ SCREEN 2 
26 OPEH “GRP:" FOR OUTPUT AS #1 


36 PRESET (160;5@) 
4@ PRINT #1,"How do you do?" 
56 GOTO 54 


In this program, the location (100, 50) used by the PRESET instruction in line 
30 is the top left corner of the character string output in line 40. 


5-6 NUMBER OF FILES OPENED ONCE 


Only one file can be specified when MSX-BASIC is initialized. In other words, 
only one file can be opened in one program at one time. When two or more files 
are to be opened at the same time, the number of lines are previously specified 
by: 


MAXFILES=5 


Based on this, 5 files with file numbers from 1 to 5 can be simultaneously 
opened. The maximum value that can be specified is 15. 


Also, since file O is dedicated to CSAVE, CLOAD, CLOAD?, SAVE and LOAD, 
when: 


MAXFILES=4 


is executed, only CSAVE, CLOAD, CLOAD?, SAVE and LOAD commands can 
be used after this. 
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6 INTERRUPTS 


An interrupt, used to suspend program flow that began during program ex- 
ecution, is caused by the occurrence of a specific external condition, and is used 
to perform other processing. The processing program executed when an inter- 
rupt occurs is called an interrupt processing program or an interrupt processing 
routine. 


Another concept similar to an interrupt is a subroutine. However, a subroutine is 
only executed when a GOSUB statement is executed in MSX-BASIC. In other 
words, the execution of a subroutine is previously determined internally in a 
program. 

On the other hand, an interrupt processing routine is executed by an external 
condition (for example, when the F1 key is pressed). 


After execution of an interrupt processing routine has been terminated, the 
execution of the main program is normally resumed the same as for a sub- 
routine. 


6-1 MSX-BASIC INTERRUPTS 


MSX-BASIC is provided with several commands to transfer contro! to an inter- 
rupt processing routine when an interrupt occurs, An interrupt can be used in 
the following cases. When an interrupt is used, its utilization is first declared by a 
command, and the starting line number of the interrupt processing routine is 


specified. 

An interrupt can be used when: Interrupt declaration command 
A function key is pressed. ON KEY GOSUB line number 
A space bar, or joystick trigger button ON STRIG GOSUB line number 
is pressed. 
+ [STOP]is pressed. ON STOP GOSUB line number 

- Sprites overlap | _ ON SPRITE GOSUB line number i 
A certain period of time has passed. ON INTERVAL = interval ; 


GOSUB line number 


For example, 


ON KEY GOSUB 1866 


is a statement that declares when a function key is pressed, it is transferred to 
the routine from line 1000. 


6-2 INTERRUPT UTILIZATION 


An interrupt cannot actually be applied by only declaring an ON — GOSUB 
statement. A command that validates the interrupt used must be executed next. 
For example, to the interrupt that occurs when the[F 1] key is pressed, execute: 


KEY¢1>) ON 


There are five commands that validate interrupts as follows. 


Command ; : Valid interrupt 
KEY (function key number) ON Interrupt by a function key. 
STRIG {joystick number) ON Interrupt by a space bar, joystick. 
STOP ON 7 . Interrupt by + [STOP]keys. 
SPRITE ON Interrupt by a sprite overlap. 
INTERVAL ON Interrupt witha certain spacing. 


= Program example 


ON KEY SOSUB 168 
KEY¢1) OW 
SCREEN 2 Main program 
LINE (56,58)-¢288,156),,6 
B0T0 468 
> SUBROUTINE 


BEEPSCLs 

FOR T=i6 TO 396 STEP 16 
CIRCLE ¢€126:-188),1 routine 
NEXT I 

CLS 

RETURN 46 


Interrupt processing 


In this program, when the[F] key is pressed, it is set so that a transfer is made to 
a subroutine from line 110 in line 10 and 20. 


When this program is executed, a rectangle is continuously displayed by line 40 
and 50 of the main program. However, when the[F1] key is pressed, an interrupt 
occurs to provide a specified transfer to line 100. As a result, the rectangle dis- 
appears with a beep sound (BEEP: CLS), and 9 circles are continuously drawn. 
After the last circle has been drawn, the screen is cleared and a return is made to 
line 40 again. 


= 


fo Interrupt processing routine 


Main program 


a pe} 
[| 


6-3 INVALIDATING AN INTERRUPT 


Lets add the following line to the program above. 


165 KEY¢1) OFF 


‘ 


Execute the program. When is pressed the first time, an interrupt occurs. 
However, it does not occur after this even when the[F 1] key is pressed. 


The reason for this is that when the interrupt processing routine was first ex- 
ecuted, 


KEY¢1L) OFF 


on line 105 was executed which invalidates the[F 1] key interrupt. 


6-4 INTERRUPT HOLD 


When execution is transferred to an interrupt processing routine by an interrupt, 
an interrupt hold state occurs. In this state, when an interrupt is applied again, 
an interrupt does not occur and a return is made to the main program by a 
RETURN statement for which an —ON statement automatically occurs, the 
main program is not executed and a transfer is made to an interrupt processing 
routine soon. 


In other words, during the interrupt hold state, a return is not made to the start 
line of interrupt processing routine when an interrupt is applied but the inter- 
rupt application is memorized and an interrupt occurs after coming out of the 
processing routine once, 
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In regard to the program on page 52, when the [Fi] key is pressed, 9 circles are 
drawn by an interrupt. However, an interrupt does not occur if the [F1) key is 
pressed before the last circle is drawn. Then, after the last circle has been drawn, 
a return is made to the main program. However, an interrupt occurs due to the 
second pression of the key and a rectangle is not drawn, but circles are 
drawn again. 


|--= Interrupt processing routine 
Main program Beep 


The key is pressed 
during the interrupt 
Co eeeienaral See ea seas => 
processing routine. 


Returns to the main program once. 


ie Interrupt processing routine 


zx Interrupt occurs soon. | Beep 
[ae ee —-——— 


6-5 VALIDATING AN INTERRUPT DURING AN 
INTERRUPT PROCESSING ROUTINE 


To further validate an interrupt during the interrupt processing routine, insert a 
command such as KEY(1) ON. As a result, the interrupt processing routine can 
be executed from the beginning by applying an interrupt during the interrupt 
processing routine. 


@ Program example 


14 ON KEY GOS5U6 166 
26 KEYCi> GN 

38 SCREEN 2 

46 LINE (58@,5¢)-¢(2668,156),,.B 
SH GOTO 448 

1648 * SUBROUTINE 


{14 BEEP:CLS 

12@ FOR I=14 TO 96 STEP 14 
136 CIRCLE (126,180), 1 

14@ NEXT I 

CLS 


RETURH 44 
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This is the same as the previous program except that the command, KEY(1) ON, 
is inserted in line 105. 

As a result, when the F1 key is pressed again while the circles are being conti- 
nuously drawn by an interrupt, an interrupt occurs immediately in which the 
interrupt processing routine from line 100 is executed from the beginning. 


Interrupt 


ae Interrupt processing routine [--=-processing 
routine 


Main program Beep 
OP: HF 
6-6 HOLDING INTERRUPT IN A PROGRAM 


To enter the hold state again after validating the interrupt with an — ON state- 
ment during the interrupt processing routine, insert a — STOP statement. 


= Program example 


10 ON KEY BOSUIB 140 

oo KEVC1) OH 

30 SCREEN 2 

48 LINE (50,509-<200,150),,B 
Sa 60TO 46 

100° SUBROUTINE 


BEEPICLS. 
FOR I=16 To 30 
CIRCLE (128,100 
NEXT I 
CLs 
160 RETURN 46 


This program is the same as the previous one. However, in this program, when 
the value of | becomes 50, KEY(1) STOP is executed in line 135. As a result, an 
key interrupt occurs immediately during interrupt processing execution if it 
occurs before the 5th circle is drawn. However, an interrupt hold occurs after 
the 5th circle is drawn and an interrupt does not occur immediately when the [FJ] 
key is pressed. 


ee Interrupt processing routine od = routine Processing 


Main program 


oP He PL 


Press the [F1] key before the 5th circle is drawn. 
re! = processing routine 
Main program Press the key after the 5th circle is drawn. 


ole} 


Returns to the main program once. 


Interrupt occurs 
here. 
oo — 


6-7 SPRITE OVERLAP INTERRUPT EXAMPLE 


When two or more sprite patterns overlap by 1 dot, an interrupt can be gene- 
rated by an ON SPRITE GOSUB statement and SPRITE ON. 


In the following program, UFOs fly from left and right and a beep sound occurs 
when the UFOs overlap. 


16 SCREEN 2 
20 SPRITES(@)=CHRECEHSC+CHRECRH7E D+ CHRE 
SR ioe alk 
CHRE(EH249+CHRSCEH4E 

36 ON SPRITE 50SUE 138 

46 SPRITE ON 

98 FOR X=6 TO 255 

66 FUT SPRITE @,¢%,100),15.6 

7@ PUT SPRITE 1,¢255-x,100)9,16,0 
SH WEXT & 

38 END 

164 SPRITE OFF 
116 BEEP 

126 SPRITE GN 
136 RETURH 
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7 MACHINE LANGUAGE 
SUBROUTINES 


With MSX-BASIC, a program can be written by using the machine language of 
Z-80A (the MSX personal computer CPU) to which control is transferred from 
BASIC, and the execution result of the machine language program can be given 
to a variable defined by BASIC. 


7-1 MACHINE LANGUAGE SUBROUTINE 
STARTING ADDRESS DEFINITION 


First secure an area where the machine language subroutine is written by using a 
CLEAR statement. Then define the starting address of the subroutine by using a 
DEFUSR statement. 


DEFUSR N = Starting address 


N is an integer from O to 9. The starting address of 10 subroutines can be de- 
fined as a USR function. 


CLEAR 288, &HDFFF 
DEFUSR1=SHEGHo 


With these statements, a machine language subroutine from address &HEOOO is 
defined as a USR 1 function 


7-2 MACHINE LANGUAGE SUBROUTINE 
EXECUTION 


Variable = USR N(1) 


The defined machine language subroutine is executed by executing the above 
statement. When the machine language subroutine has been executed, the value 
of the execution result is given to a variable, and the BASIC program is also 
continuously executed 


When execution is transferred to a machine language subroutine, the value of ‘‘I"’ 
specified as a USR function parameter is given to a subroutine. 


| xu SRICID __ | 
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The value of variable | is stored at the following memory location by the above 
statement, and at the same time, data that indicates the type is entered to 
register A depending on the type of |. The starting address of the area where the 
value of | is stored is entered to the HL register. 


Type of | Data input HL register address | Address where the value of 
ype to A register* indication | is stored. 


Integer type &HF7F8—&HF7F9O 


= &HF7F6 &HF7F6—&HF7FO 
Double-precision 
pou | oe | &HF7F6—&HF7FD 


*The same data is input to the &HF663 memory address. 


When | is a string type variable, the above mentioned is as follows. 


String descripter 


Data input 
to DE register 


Data input 
to A register 


String Ist byte: Length of character string 
descripter 2nd and 3rd bytes: Starting address of the area 
starting where the character string is 


address stored. 


When execution of the machine language subroutine has been terminated, the 
value of the result is given to variable X by setting the register and memory 


during termination. 
&HF663 

aaa — ne perstecety se neisal a a 
address 

&HF7F6 &HF7F8—&HF7F9 


a 
ho &HF7F6 &HF7F6—&HF7F9 


|e | 
type 
type f 
3 Area start address 


String type 

indicated by the 
2nd and 3rd string 
descripter byte. 


String 
descripter 
starting 


7-3 MACHINE LANGUAGE PREPARATION 


A machine language subroutine is written to memory by using a POKE state- 
ment. 

A return from a machine language subroutine to the BASIC program is ac- 
complished with a RET instruction. 
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CHAPTER 3 
COMMANDS, FUNCTIONS AND STATEMENTS 


1. SYSTEM CONTROL AND SYSTEM VARIABLES 


of \:) 2 a eee 64 OAD) cccorsecem:stcrsueritacs 6 102 
BEGAD  wacam. on susie ox 65 RLOGAME: cise narvate. we 103 
BSAVIE seas ce cps Fe 66 EROS mxcicyeany cnitandeas iva, mere 104 
GALL sauce 26. Serie ai 66 JOPLIN xxpeanatts: atermawtevera: tram 104 
CLOAD: Scie He rates Se 69 LPRINT USING ........ 104 
SLOAD?: cxsere oy 2: peers a 70 MERGE ste: reinvent 105 
GONUE wiscesosseank dastareneners: ans i2Z MOTOR ones. cas a oes 107 
SNE a stonssche era eaniaversane 72 EW a a Sa keia Bien eeendlin Sind 108 
BoD) yscearstevevats.cesotueretec as 81 PEIN deusiucssonsvsnncnavuwaonn Biers 135 
4 a ee eee ee 94 BEAN Ee conpvanepnbaneneceisine’ aioe 135 
KEMEIST cas aenccson:es 95 SO Fe ecresezacine-ausuepernatecatete 141 
MEV ON benassi as 95 MONEE onercruanareediiniaie Gieaankie 146 

OFF WEEP WIEN . xceue-cnevarais, teense 148 
i (5 re eae eTs 101 SAU save sivia: akan srereecte wishes 149 
2), ee eae 102 WIDTH............... 152 


PAT br éceunzavenaneratoseasiepevans 63 > GCS). 96 
GLEAR incu aruda 69 OFF 
BD PRIAS ss cideaxnseustsdaensueusnete 74 STOP 
BE RUSAY isis wis teres 76 LEE” cs rata aks cpeanewtente. ves 98 
DELETE) asiekin ohare 76 ON ERRORGOTO ..... 108 
DUM: 0% temien ox eters ae ON-GOSUB) « sscaaws. can 109 
ERASE): sc2s%cs texas 82 ONGORG anreigeeas oes 110 
ERROR: dccasess oc Aare 83 ON INTERVAL GOSUB 
FOR-NEXT ........... Yn OT oA et ect 110 
GOSUB-RETURN ...... 86 ON KEY GOSUB isis ays 111 
GOTO? seccrcnewavaratrenitraverenave 88 ON SPRITE GOSUB .... 112 
IF-THEN ON STOP GOSUB ...... 112 
2S 89 ON STRIG GOSUB ..... 113 
INTERVALON ........ 94 Pee weseigaicoreae raretronweahe:loie ce 116 
OFF Be sakes rarchocudaracehenws. 008% 121 
STOP READ)  swterenc:aceruvertowsy 129 
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RENUM ............-. 131 OFF 
RESTORE sic ivanewncs 132 STOP 
RESUME xxsuscacveevs 182 GWAR go eoevcedcencws 144 
SPRITE ON ix cciexs.sa 140 THOFF 6c oc coe cen 146 
OFF TRON ............... 147 
STOP [a ee 147 Al 
STOPON ........-.0-- 142 WAIT................ 152 FF 
OFF 
STOP & 
D 
FUNCTION AND STRING CONTROL E 
MEE. csnnachuorasinvaiawmnviin 62 INSTR............... 93 fa 
aaa a |: nnn 4 Ie 
BM iwssateveinsiiinerwe- sin BO PETS nen orevcxcavas 96 
BING ....ccceceeeeeee = neon 97 fm 
GI oses-paven crwsacewer > eee 103 
Te re 67 MID $ (FUNCTION) 106 
BINT cvccewua'saeuseus OF WB esses 7: ces os 107 fs 
I coeties ca scone: arise Pa: | nn ios 
ORIN sek aedracdoniiechiara tes TZ POS voce cccccccvcvecs 121 
CSRLIN ..........-0-- 73. RIGHTS ............. 133 
DEFFN..........-.-. 74 +RND................. 133 YF 
DEPINT suse sevseae 75 SGN...............-. 137 
SNG SIN .cccccceseecceeves 138 £& 
DBL SPACES ox azocecc cece 139 
STR WEN coche ns ix ceerativa. as 139 
he a |, OP apetapecnenien 140 [ia 
| B82 STR$..... cc cece cess 143 TB 
EXP ........-- see e eee 83 STRINGS ............ 144 
84 TAB................. 145 fu 
FRE ecscvicwivasiotsomneossidk tre 86 TAN.........c.eee00. 145 FT 
HESS: cvacweaceuscmin BQ VAL cv cinias csseences 148 
V 
W 
SOUND CONTROL 
BEEP. ceicthoreuwansenien 64 PLAY (FUNCTION) .... 120 
PE ctor sence at 116 SOUND .............. 138 


5. GRAPHIC AND SPRITE 


COCR ivcns teenies 68 
DLS ichisavserneneds 71 
COG clare aivawa ey 71 
i) See ee eee 77 
LING ice%0ennsee memes 99 
cle) MEO ee ree 115 
PORN, ect: his exarndian pln aie 120 
PRESG! Facade nnede- ey 122 


PRINT: situs srewarsovwe 122 
PRINT USING e226 css 124 
PRED s2.0ak na HiMea-ediah 128 
ed ee ee 128 
8S) ee ee ee 136 
“ge 140 
A ge eee 151 
ie ere oer eee 152 


PEM 2.20 ees eS 113 
Cay sk ia ORR eae 114 
BAO 6 Gerad gabe ie 114 
| Sea ea ee ee 116 
PU ee xs ie Met sieht 127 
PRINT #USING ....... 127 
BE PERS toni cin iccaurs tania 141 
| See rae 142 


6. FILE AND I/O CONTROL 
CHDEE sc yerws vrewens 70 
eee 81 
WEY © ccicapcniasas 90 
| ere 91 
PLD sue ditentse aesdied 91 
i 92 
IPN sixes aowanie 93 
LIME INPUT ix svscasiee en 100 
LINE INPUT #......... 100 
WARPILES: wosc0¥ on veces 105 
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In this chapter, MSX-BASIC commands and functions are explained 
in an alphabetical sequence. 


INTRODUCTORY REMARKS 
In regard to a function, is written in front of the function name. 


eee Commerc; function name 


PSET| (point set) ay 


Function 
OO FORMAT 
PSET [STEP] (X-coordinate, Y-coordinate) [, color] Format 


X-coordinate, 
Y coordinate 


Numerical constants, variables, array variables and their 
expressions from —32768 to 32767. 


——Input condition 


Color Integers from 0 to 15. 
Current foreground color —— When input is omitted 


(1 FUNCTION AND UTILIZATION 
Supplementary command and function explanations, and execution examples in which 
commands and functions are utilized. 


Input item omission 
An input item inside [ ] in the FORMAT section can be omitted. 


Example 


For SCREEN [Mode], [Sprite size] , [Key click switch], [Baud rate] , [Printer type] , when 
only the mode and sprite size are specified, it is as follows. 


SCREEN 2 2 3 Ce Items after this, including commas, can be omitted. 
When only the printer type is specified, it is as follows. 
SCREEN >;;:;1 
‘—=—"—_ commas cannot be omitted. 


Input item omission 


Example 
DATA Constant [, Constant] 
As many constants as desired can be repeated after DATA within the input range per line. 


64 


ABS (absolute) 


Gives the absolute value for numeric data. 


[) FORMAT 


ABS(X) 
Xx | Cond. Numeric constants, variables, array variables, and their expressions 


Given value Numeric type 
Y 


[) FUNCTION AND UTILIZATION 
Gives X when X = 0 and —X when X <0. 
EXECUTION EXAMPLE 


PRINT HESeS3 


- 


PRINT ABS¢3-185 


ASC 356 | EEE NE GTS I 


Gives the character code for the first character of string data 


CO) FORMAT 
ASC(X$) 


x$ [Cond String constants, variables, array variables, and their expressions 


Given value Single-precision integers, decimal expressions 


(J FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRINT ASCE"g" > 


160- —— Character code of “'d” 
PRINT ASCC "data" 
186 - ~ Character code of “d’’ 
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ATN (arc tangent) i 


Gives the arc tangent value for numeric data. 


C) FORMAT 
ATN(X) 


x Cond.| Numeric constants, variables, array variables, and their expressions 


Given value Numeric type 
C) FUNCTION AND UTILIZATION 


The ATN function gives a floating-point type numeric value which indicates an angle in which 
the value of the trigonometric function, tan, is X. Its unit is a radian, To obtain the result in 
degree units, multiply 180/x 


EXECUTION EXAMPLE 
PRINT ATH¢1) 


35, 888038009965 — unit is degrees 


eS 5 RA A RG 


Line numbers are automatically generated from a specified line number with a 
specified increment 


CO) FORMAT 
AUTO [starting line number) [, increment] 
Starting line number [Cond An integer from 0 to 65529 


[Omit | 0. However if, increment’’ is omitted, it is 10. 


Increment [ Cond.] Integers from 1 to 65529 
[Omit | 10 


(1) FUNCTION AND UTILIZATION 


Used to eliminate the keying in of line numbers while entering a program 


@ When a program staternent exists for a generated line number, *’»"’ appears on the right of 
the line number. To modify this program statement, move the cursor to *'*, then input a 
new statement after deleting ‘*»’’ with a space. When no modification is required, press 


RETURN. 
@ To stop automatic line number generation, press |STOP| while pressing [CTRL} or press (cj 


while pressing [CTR L 
EXECUTION EXAMPLE 


100.58 
PRINT" 12345" 


ne 
mi 
P+ 


-|ndicates that line number 150 exists 
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HBR 9° (bos ee aes 


Used to read and write a VDP table base address 


() FORMAT 


BASE(N) 

BASE (N)= expression 
N [Cond.| Integers from 0 to 19 
Expression [Cond] Integers from 0 to 65535 


() FUNCTION AND UTILIZATION 


Used to read or rewrite a VDP table base address in memory 
BASE(N) corresponds with the base addresses shown in the table below depending on the 
value of N. 


Value of N Table 


40 characters x 24 lines text mode pattern name table. 
40 characters x 24 lines text mode pattern generator table. 


32 characters x 24 lines text mode pattern name table 
32 characters x 24 lines text mode color table. 

32 characters x 24 characters text mode pattern generator table 
32 characters x 24 characters text mode sprite attribute table 
32 characters x 24 characters text mode sprite pattern table. 


High resolution graphic mode pattern name table. 
High resolution graphic mode color table. 

High resolution graphic mode pattern generator table. 
High resolution graphic mode sprite attribute table. 
High resolution graphic mode sprite pattern table. 


Multi color mode pattern narne table 
Multi color mode pattern generator table 
Multi color mode sprite attribute table. 
Multi color mode sprite pattern table 


N=1, 3, 4, 16 are not used 
Precautions 


The register contents and the table base address of the TMS9929A, which is the screen display 
LSI, can be directly modified by using a BASE variable and a VOP variable. However, ade- 
quate knowledge of the TMS9929A is required to perform this. If the base address is care- 
lessly rewritten, a normal screen display can not be performed. Therefore, precautions shal! be 
taken 


GE BEEP (beep) 


A beep is sounded. 


C) FORMAT 
BEEP 


—~64— 


() FUNCTION AND UTILIZATION 


EXECUTION EXAMPLE 
This program generates a beep sound 10 times 
FOR J=6 TO 9 continuously. 
BEEP 
NEXT I 


EMMY GINS (binary dollar) es CE 


Gives a binary expression of numeric data as string type data. 


C1) FORMAT 


BINS(X) 


x Cond.! Numeric constants, variables, array variables, and their expressions from 
—32768 to 65535. For a negative number, it has the same value as if its 
value was added to 65536. 


Given value: String type 


(1) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRINT BIN#¢ 188) 
1166166 


GEE BLOAD (binary load) 


Loads a machine language program, or loads and executes it 


CO) FORMAT 
BLOAD “device name [file name)” [, R) [, offset] 
Device name | Cond} CAS Cassette tape 


File name Cond] String within 6 characters. If 7 or more characters are specified, 
the 7th character and after and ignored 
Omit | Loads the file which was found first 


R option Omit | Load only 
Offset Cond,| Integers 
Omit 0 


—6§5— 


[] FUNCTION AND UTILIZATION 


Loads a machine language program saved by a BSAVE statement at an address between the 

starting address and an end address specified by a BSAVE staternent. If offset is specified, the 

value is added to the starting address and end address 

elf, R is specified, the program is executed after load termination. At that time, the ex- 
ecution start address is an address specified by a BSAVE statement 


BEE 8SAVE (binary save) aT 


Saves the content within a specified memory range with binary 


0 FORMAT 
BSAVE “device name [file name] ’, starting address, end address, [execution start address) 
Device name Cond. CAS Cassette tape 
File name [Cond] String within 6 characters. If 7 or more characters are specified, 


ss the seventh character and after are ignored. 
Omit Null string 


Starting address, end address 


Cond] Integers 
Execution start address 
Cond] Integers from —32768 to 65535 


[Omit | Considered as a starting address 


() FUNCTION AND UTILIZATION 


Saves the content within a memory range from a starting address to an end address with 

binary code which is used for saving machine lanquage-. 

@ lf an execution start address is specified, execution starts frorn the address specified when 
the machine language program was loaded by a BLOAD statement with an R option. If 
omitted, the starting address is considered as an execution start address 


EXECUTION EXAMPLE 


BSAVE"CAS:PROG4", 


Pe eR oe eee 


Executes an extended command 


() FORMAT AND FUNCTION 


CALL extended command [(argument, argument. . .}] 


Argument [Cond] Integer constants, variables, array variables, and their expressions 
~ Character constants, variables, array variables, and their expres 
sions 


When an extended command is provided by a ROM cartridge etc., it can be executed by a 
CALL statement 
@ —(underline) can be utilized instead of a character CALL 


—66— 


CDBL (convert to double precision) a 


Converts numeric data to double precision data. 


C1) FORMAT 
CDBL(X) F 
x Cond Numeric constants, variables, array variables, or their expressions 
Given value ~ Double precision numeric type 


(J FUNCTION AND UTILIZATION 


Given numerical data is internally treated as double precision data by the CDOBL function 


CHR$ (character dollar) 


Gives the character of a specified character code 


C) FORMAT 
CHRS(X) = 
x [Cond] Numeric constants, variables, array variables, and their expressions 
a from O to 255. 
Given value String type 


() FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRIHT CHR$<¢1003 See the character code table (page 165). 
d 


CINT (convert to integer) as 


Converts numeric data to integer type data 


[) FORMAT 
CINT(X) , 
x |Cond,| Numerical constants, variables, array variables, and their expres 
sions from —32768 and less than 32768 
Given ‘value Integer type 


() FUNCTION AND UTILIZATION 


When numeric data X is an integer value, it is maintained as it is. When it is a floating point 
type value, it is converted to an integer value by omitting values below the decimal point 
It differs from the INT function in that the INT function gives the whole number out of X 
while CINT converts X to an integer in which the internal processing is different 


= G7 = 


EXECUTION EXAMPLE 
PRINT CINT¢972) 
4 


PRINT CIHT¢{124#2?88#5535 
Overflow 


RR 


Draws a circle, oval, a part of a circular arc or a fan shape on the foreground in the 
graphic mode. 


O FORMAT 


poral [STEP] (central coordinate), radius, [color], [start angle], [end angle], [aspect 
ratio 


Central X-coordinate, Numerical Constans, variables, array variables, their 
central Y coordinate expressions from —32768 to 32767. 


Radius Numerical constans, variables, array variables, their 


expressions from —32768 to 32767 


Cond 
Color Cond Integers from O to 15. 


Omit | Current foreground color 


Start angle Cond.| From —2n to 2m (unit is radians). 


0 
End angle From —2n to 2m (unit is radians). 
2n 


Aspect ratio Cond.| Positive numerical constants, variables, array variables, 
their expressions. If the aspect ratio is omitted, an oval is 
drawn 

Omit 1 


[) FUNCTION AND UTILIZATION 


Draws a circle with a specified radius and with specified coordinates as its center. When a 
Start angle and end angle are specified, only a part of a circular arc is drawn. A fan shape can 
be drawn by placing — (minus) for the start angle and end angle. An oval can be drawn with 
an aspect ratio by specifying the power of the vertical radius for the horizontal radius 

* See page 29 for STEP specifications. 


EXECUTION EXAMPLE —— 
1@ CLS f 
20 SCREEN 2 


30 CIRCLE (50,50),30,,,.4 mn eden 
49 CIRCLE STEP(70,7@),30)5+..25 
59 S0TO 5a —_ 
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RRR CLA oo aS TS 


Initializes all variables and sets the size of the character area and the highest 
memory address used in BASIC. Also, closes all open files, if any. 


[) FORMAT 


CLEAR [size of character area] [, highest address] 


Size of character area | Cond Numeric constants, variables, array variables, their expres 
= SIONS 
[Omit | Current set value (initial state is 200). However, the 
character area size cannot be independently omitted 


Highest address Cond,| Numerical constants, variables, array variables, their 
expressions 


Omit] Current set value 
() FUNCTION AND UTILIZATION 


EXECUTION EXAMPLE 


All variables are initialized by this statement. Also, the 
CLEAR 468,55296 size of the character string area is set to 400 bytes and the 
~ . : “ “highest address of the BASIC program area is set to 55296 


GE CLOAD (cassette load) 


Loads an MSX-BASIC program from cassette tape. 


[) FORMAT 
CLOAD ["‘file name"’] 
File name Cond} String within 6 characters. If 7 or more characters are 


specified, the seventh character and after are ignored 
[Omit Loads the first program file found 


() FUNCTION AND UTILIZATION 


EXECUTION EXAMPLE 


a dean jiae —a Loads the program with the PROG] file name from 
CLOAD F F u 61 cassette tape to memory 


@ When an error occurs during load, rewind the tape to reload it 


=. 


HE CLOAD? (cassette load verify) 


Compares a program saved on cassette tape with one in memory. 


(1) FORMAT 
CLOAD? [“file name”) 
File name [Cond] String within 6 characters. If 7 or more characters are 


_. specified, the seventh character and after are ignored 
Omit | Compares the first program file found with one in 
memory 


(1) FUNCTION AND UTILIZATION 


A command that checks if a program is correctly saved or not. When it is executed, the 
program in memory is compared with a program saved on cassette tape with a specified file 
name 


@ After comparison shows that the programs match, OK is displayed and input wait occurs 
When they do not match, ‘Device |/O error” is displayed and input wait occurs 


elf the file name is omitted or CLOAD? "\_u” is input, the first program file found on a 
tape is compared with the program in memory, (LI means a space.) 
EXECUTION EXAMPLE 


CLOAD?"PROG1" 


OE clon.) i Ra aa a aS 


Closes a file which was opened by an OPEN statement. 


CO) FORMAT 
CLOSE[+#] [file number] [, file number]... . 
File number [Cond.| 1 < file number < numeral specified by MAXFILES = 


statement 
{Omit ] Closes all the files. 


1) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


16 MAXFILES 
2 SCREEN 2 
OPEN “GRPS"FOR OUTPUT AS #1-————opensfite 1 
OPEN "GRP!"FOR OUTPUT AS #2-———openstite2 
OPEN "GRP:"FOR OUTPUT AS #3 peaieeinnnn 
PRINT #15 "ABC" 

PRINT #2, "DEF" 

PRINT #3, "GHI" 

CLOSE - 
414 GOTO 168 


Cn 


| 
a 


Closed all the files 


Woo J oO On ca ho 
Ooo goa ae 


_ 
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ME CLS (clear screen) a 


Erases all displays on the screen 


[) FORMAT 
cLs 


ein the graphic mode, the background color is changed by executing CLS after specifying it 
with a COLOR statement. 


SR Oo SE RT 


Specifies the color of the foreground, background, and border area 


[1 FORMAT 
COLOR [foreground color], [background color] , [border color] 
Foreground color, background color, border color 
[Cond |] Integers from 0 to 15. (See the color table below.) 


———— 
Omit Current color 
@ Color code table 


Code - Color Code Color Code Color [Code Color 
O | Transparent 4 | Dark blue 8 | Medium red 12 | Dark green 
1 | Black 5 | Light blue 9 | Light red 13 | Magenta 
2 |Medium green} 6 | Dark red 10 | Dark yellow 14 | Gray 
3 | Light green 7 | Sky blue 11 | Light yellow 15 | White 


[) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


COLOR 6° —Only the foreground color (character color in text mode, and 
graphics color in graphic mode) is changed 


COLOR »Z- — Only the background color is changed 
COLOR 3; 1 1*—Only the border area color is changed 


COLOR 15,4,4Initialized 
®@ See page 26 for the screen configuration 


@\in the graphic mode, the background color is not changed by only specifying the back- 
ground color with a COLOR statement but is changed only after executing CLS 


= bo 


GE CONT (continue) 


Restarts a program 


[) FORMAT 
CONT 
[} FUNCTION AND UTILIZATION 


[noe ] ——y ~ 
Restarts a program that was interrupted by [CTRL] + [STOP] or by a STOP statement in a 
program. When a CONT statement is executed, execution starts from the statement next to 
the interrupted statement. However, if an interrupt occurred during the execution of an 


INPUT statement, execution starts from the beginning of the statement 


COS 105105) aaa ee Rea ee ames ay 


Gives the value of the cosine for numeric data 


CL) FORMAT 
CcOS(xX) 
X [Cond | Numeric type constants, variables, array variables, their 
expressions. (Unit is radians.) 
Given value Floating-point type constants from —1 to 1 


() FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRINT COoS¢ 


TAB45 96 


PRINT COSC66*3, 


To give X in degree units, use the formula COS (X * 2/180) 


GEE CSAVE (cassette save) 


Saves an MSX-BASIC program file on cassette tape 


C) FORMAT 
CSAVE “file name” [, baud rate] 
File name [Cond.] String within 6 characters. If 7 or more characters are 
specified, the seventh character and after are ignored 
Baud rate [Cond.] 1 (1200 baud) or 2 (2400 baud) 


[Omit | 1 (1200 baud) 


re 5 


() FUNCTION AND UTILIZATION 


Although up to 6 characters can be used for a file name, a numeral cannot be used at the 
beginning. As for the baud rate, when 1 is specified, the baud rate is 1200 baud, and when 2 is 
specified, it is 2400 baud 


EXECUTION EXAMPLE 
7 - Saves a BASIC program in memory to cassette tape with a 
CSAVE "PROGI" file name “PROG1” 


Es CSNG (convert to single precision) I 


Converts numeric data to single precision data. 


[) FORMAT 
CSNG(X) => 
x | Cond ] Numeric type constants, variables, array variables, their expressions 
Given value Single-precision type 


[) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


1@ PRINT SQR¢3) 
26 PRINT CSNG¢S@R¢3) 
RUN 
1.7326508875688 
1.73285 


CSRLIN (cursor line) is 


Gives the Y-coordinate of the cursor location. 


1 FORMAT 
CSRLIN 


FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


16 CLS 

26 INPUT AS 

38 PRINT A$; 

44 CL=CSRLIN 

3@ LOCATE @,CL+3:PRINT "END" 


The character data displayed by line 30 occupies only one line or plural lines depending its 
length. However, the Y-coordinate (vertical location) of the cursor after display is input to 
variable CL and “END” is displayed with a value which is greater than CL by 3 as-the Y- 
coordinate. Therefore END” is displayed 3-lines below notwithstanding the A$ data length 


C 


my ic ae 


KR OR ea) 


Gives data read by a READ statement 


[]) FORMAT 
DATA constant [, constant]... . 
Constant [Cond] Numeric or string type 


CL) FUNCTION AND UTILIZATION 
@ When data items are arranged in one DATA statement, they are punctuated by a comma (,) 


@\f data in a DATA statement sequentially matches variables ina READ statement, it can be 
located anywhere for a READ statement and as many DATA statements as desired can be 
utilized 


@When string type data includes a comma (,) or colon (:), or when a space is inserted in front 
and at the back, it is placed inside quotation marks ('*) 


EXECUTION EXAMPLE 


18 CLS 
28 SCREEN 2 


READ A>E,C;0 

LINE ¢A,B>-<C,0) 
DATA 8.6,255,191 
BOTO 6& 


mene clr 
imc ce 


ME «DEF FN (define function iii 


Defines a user function 


1 FORMAT 
DEF FN function name [(parameter [, parameter] ... .)] = expression. 
Function name [Cond] Numeric type, string type variables (Type is in accord 
with the expression.) 
Parameter [Cond.] Up to 9 variables 
Expression [Cond] Numeric type, string type constants, variables, array 


variables, their expressions 


CL) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 

DEF FNACK, Yo=CKeZey e: 

2H B=FHAC4; 2) 

WH PRINT E 

MH 


»4CK-4¥) 


__ 
—, 
aa! 


4r 


= 


a) 


; 
In line 10, the function FNA(X,Y) is defined as the following expression. In line 20, 4 and 2 


are given as values for the X and Y parameter, then the function is called. The result, 7, is 
assiqned to variable B 


=? 


GEE DEFINT (define integer) 


DEFSNG (define single precision) 
DEFDBL (define double precision) 
DEFSTR (define string) 


Defines the correspondence of the first character of the variable name and the 
variable type 

(INT; Integer type, SNG: Single precision, DBL: Double precision, STR: String 
type.) 


O 


FORMAT 


DEFINT character [ — character] 
DEFSNG character [ — character) 
DEFDBL character [ — character] 
DEFSTR character [{ — character] 


Character | Cond | One alphabetical character 
FUNCTION AND UTILIZATION 


" = As a result, all the variables, starting with characters A—C, are 
1 ; = : ’ F 
DEPINT 8-0 Giestone 


Priority of type declaration characters (%, !, #, $) 
After declaring DEFINT A, A becomes a double-precision variable by declaring A# later 


EXECUTION EXAMPLE 


14 DEFINT A-C- a ~ Variables from A to C are integer type 
24 A= 1 e ds 345 Ser rf 33 — Variables A, ABC become integer type 
a i 4 

36 ABC=1.23456789 by line 10 

: ried le ate 

40 84=1. 23456789~——_—boueoneison pe by oi 


66 C!=1,23456789 
7a PRINT AsABCSB#sC! 
RLM 


1 1 1,.23456789 1.23457 


 Single-precision type by placing ! 
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GE DEFUSR (define user) ay 


Specifies a starting address when a machine lanquage subroutine to be called by a 
USR function, 


LC) FORMAT 
DEFUSR [X) = starting address. 
x [Cond | Integers from 0 to 9 
[Omit } 0 
Starting address [Cond.] Numeric type constants, variables, their expressions from 


0 to 65535 
C) FUNCTION AND UTILIZATION 


EXECUTION EXAMPLE A ' 7 —e 
‘ ep4 as a S a result, a machine language subroutine which starts 
DEFUSR1=&HEGBG trom address &HEOOO is defined as USR1 


@ The starting address can be redefined as many times as required in one program without 
changing the value of user number (X) 
(See page 56 for Machine Language Subroutines.) 


GRRE DELETE (delete) as 


Erases a specified line in a program 


CL) FORMAT 
DELETE [line number] [ — line number) 
Line number [Cond ] Integers from 0 to 65529 


(1) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


DELETE 46- Erases line 40 
DELETE 26-40- Erases lines from 20 to 40 


DELE TE -Se Erases lines from the starting line to line 50 


DELETE oe Erases a line displayed last by a LIST statement 
or a line that was interrupted due to an error 


@ When only one line is to be erased, input the line number only and press | RETURN! 
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EE OM (dimension) [a 


Declares the name of an array variable, data type, size and dimension 


C]) FORMAT 


DIM variable name (maximum value of a subscript [, maximum value of a subscript] ...) [, 
variable name ( ),....] 


Variable | Cond Numeric or string type 

Maximum value of [Cond.] Integer type constants, variables, array variables, and their 
a subscript expressions over 0 

Maximum dimension 255 dimension 


C) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


[i I i A c 15 y Sets up an area of 16 numeric type array variables from A(O) to 
eRe aees A(15) in memory. The initial value of variables is O 


(i IM E $i a ES , Sets up an area of 12 variables as shown below (string type). The 
=e initial value of variables is a null-string 


B$(0, 0) BS$(1, 0) BS(2, 
BS(O, 1) BS(1, 1) BS(2, 
_B$(O, 2) BSi1,2) | Bgi2, 
B$(O, 3) BS(1,3) | BS(2, 


To define a plural number of array variables by one DIM statement 


ie IM AC? > ie BSc hs P4, oR sz eee eae is punctuated with a 


Multi-dimensional array variables 
Multidimensional array variables are generated by specifying 2 Maximum values or more 
for subscript 


D I M * t 4 3 4 3 5 ) —— 3 dimension 
DIM statement omission 


When an array variable is utilized without declaring a DIM statement, the maximum value of 
the subscript is considered to be 10 


CGR ONAN on) STE GE 


Draws graphics on the graphic screen as specified in graphic subcommands 


OC FORMAT 
DRAW subcommand 
Subcommand Cond J Character string (constants) inside “ “ or string type 


variables in which a character string is assigned. Capitals 
or smal! characters 


SS 7 


An 
(angle) 
Mx, y 
(move) 
M+x, ty 
(move) 

Un 

(up) 


OS x < 255 
O¢y<i191 


O<x < 255 
osys191 


Specifies the number of dofs for 
1 unit when a line is drawn. 

1/4 dot with n=1. 
Initialization is S4. 


Rotates coordinate system by 
step of 90° for a standard co- 
ordinate axis (0°). 
Initialization is AO. 


Specifies a color for a line drawn 
by a color code. 
Initialization is C15. 


Draws a line fram a current point 
to an absolute location (x, y). 


Shifts horizontally tx from a cur- 
rent point and +y vertically. The 
unit for x, y is the number of 
dots specified by the S subcom- 
mand. 


Draws a line toward a negative 
direction on the Y axis from a 
current point to another point 
by an n distance. The unit of 
n is the number of dots specified 
by the S subcommand. 

(1 if omitted.) 


Draws a line toward a positive 
direction on the Y-axis from a 
current point to another point 
by an n distance. The unit for 
n is the number of dots specified 
by the S subcommand. 

(1 if omitted.) 
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Currant Point 


oe 7 


Current point 


Draws a line in a positive direc- 
tion on the X axis from the cur- 
rent point to another point by an 
n distance. The unit of n is the 
number of dots specified by the 
S subcommand. 

(1 if omitted.) 


Draws a line in a negative direc- 
tion on the X-axis from the cur- 
rent point to another point by 
an n distance. The unit of n is 
the number of dots specified by 
the S subcommand. 

(1 if omitted.) 


Draws a line in a positive direc- 
tion on the X-axis and in a 
negative direction on the Y- 
axis from the current point to 
another point by an n distance. 
The unit of n is the number of 
dots specified by the S subcom- 
mand. (1 if omitted.) 


Draws a line in a positive direc- 
tion on the X-axis and in a 
positive direction on the Y-axis 
from @ current point to another 
point by an n distance. The unit 
of n is the number of dots speci, 
fied by the S subcommand. 

(1 if omitted.) 


Draws a line in a negative direc- 
tion on the X-axis and in a 
positive direction on the Y-axis 
from a current point to another 
point by an n distance. The unit 
of n is the number of dots speci- 
fied by the S subcommand. 

(1 if omitted). 


Draws a line in a negative direc- 
tion on the X-axis and in a 
negative direction on the Y- 
axis from a current point to 
another point by an n distance. 
The unit of n is the number of 
dots specified by the S subcomma 
nd. (1 if omitted.) 


C] FUNCTION AND UTILIZATION 


The current location is always stored with a command to draw a line except Sn, An, Cn, 
For example, 


DRAW "M1@@,120" 


er {: 


by the message above, when a line is drawn from a certain point to another point (100, 120), 
then this point becomes the current point. Then, when a command to draw a line is made 
again, a line is drawn from this current point to a specified point. 


One of the following two commands can be placed in front of a command to draw a line, 

Bic Although the current point is shifted, a line is not drawn. (Exarnple: BMO, 0) 

Nese nla a line is drawn, the current point is not shifted. (Example: NU30, 30, NR30, 
30 


To express a subcommand with a variable 


AS="BMN140, 15@USGES5GF 58056L166" 
DRAW AF 


In this example, a subcommand is assigned once to a string type variable A$, then A$ is speci- 
fied as a subcommand in a DRAW statement. 


To express a part of a subcommand with a variable (X variable;) 


A$="U2GRZADZOL20" When 2 itcormard awanad os ye 
DRAW "BMSa@,5akAas;s " ment, add X before and ";" after that. In this 


DRAW "BM15@.1@QXA$$" fino ORAWstatements oS SUS 


To express n in a subcommand with a variable (=variable;) 


n which expresses the shift distance, angle and color code with each subcommand can be a 
constant or a variable in a DRAW statement, When it is expressed with a variable, add = 
before and "’;”" after that. 


s=48 
DRAW "U=K5" 


is the same as 


CRAW "U4e" 
EXECUTION EXAMPLE 


16 SCREEN 2? = Graphic mode when a DRAW statement is used. 
°0 DRAW "BM125,166"+— te (125, 100) without drawing anything. 
36 FOR I=4 TO 246 STEP 12 

#0 DRAW "S=TsBURDZL2U2RBD" --— sty re 
64 GOTO 66 


ME END (end) 


Terminates program execution to enter a command wait state and closes all the 


opened files. 


(1) FORMAT 
END 


[) FUNCTION AND UTILIZATION 
The END statement is used in the last line of the main program when a subroutine is written 
after a main program to prevent a subroutine from being executed again after the main prog 
ram is terminated. It can be used as many times as desired in one program such as when a 
program execution result is branched into some result, it can be used at the end of each 
branch 


@A RUN or GOTO statement is used to execute it again. It cannot be resumed by a CONT 


statement. 
. 


100 GOSUB 1000 


= In this program, if an END statement does not exist 
1 98 in tine 200, the subroutine from line 1000 is entered 
°86 END without a GOSUB statement after returning from a 
< Spat 
subroutine and executing line 190, and an occurs. 


1886 *SUBROUTINE 


1100 RETURN 


EOF (end of file) as 


When the last data of a file has been read, —1 is given, otherwise O is given. 


1 FORMAT 
EOF (file number) : 
File number [ Cond. | 1 < file mumber < numeral specified by MAXFILES= 
~ statement 
Given value Integer type (—1 or 0) 


[) FUNCTION AND UTILIZATION 


When the last data is read while data is 
sce 4% -~ ~ being read from the file whose file 
I F EDF \ 1 ? 1 HE Mf GL 0 SE 4 1 number is 1, a file is closed by the above 


statement 


= 


GES ERASE | occ 2) SRS Ree Ae 


Erases an array variable, 


CL] FORMAT 


ERASE array variable name [, array variable name] .... 


() FUNCTION AND UTILIZATION 


14 ie I i A¢é 16 a aa BS Ca. 4 y In this example, array variables A and B$, 

declared in line 10, are erased in line 100 
After this, the memory area can be used for 
another purpose. Also. an array variable 
with the same name can be redefined by a 


188 ERASE Ms ; BS DIM statement 


ERL (error line) iia 


Gives the line number of a line where an error occurred 


() FORMAT 
ERL 


Given value Numeric type 


(J) FUNCTION AND UTILIZATION 


When no error has occurred, O is given. When an error results from a direct command, 65535 
is given, Is used by combining it with an ON ERROR statement or an ERROR statement 


CRE 01. ee TE sia I aa 


Gives the error number of an error that occurred 


_] FORMAT 
ERR 
Given value Integer type 


[) FUNCTION AND UTILIZATION 


Can be used for error processing in a program by combining it with an ERROR staternent or 
ERL function 


@ When no error occurs, O is given 
EXECUTION EXAMPLE 
PRINT 16-8 
Division by zero 
PRINT ERR 
11 


_~82— 


pi: RM 


Simulates an error of a specified error number or defines an error number 


OC) FORMAT 
ERROR error number 


Error number Cond Numeric type constants, variables, array variables, their 
expressions from O to 255. 


C) FUNCTION AND UTILIZATION 
ERROR 1 


Generates a NEXT without FOR error. (Stops program execution.) 


User definition of error number 
If A< 0 THEN ERROR 250 


When a negative numeral is assigned to variable A based on the above, error 250 occurs. (Since 
error numbers up to 59 are defined in MSX-BASIC, numbers larger than those shall be used.) 


EXECUTION EXAMPLE 


When a negative numeral is input in the following program, a message is displayed that indi- 
cates a positive numeral is required, and program execution continues 


16 ON ERROR GOTO 96 

FOR I=1 TO 16 

INPUT A 

IF A<@ THEN ERROR 258 
SUM=SUM+A 

NEXT I 

PRINT SUM 

END 

96 IF ERR=256 THEN PRINT "Input 
Fositive number." RESUME 36 
BA PRINT "Error!" 


ow om one ot 
Sooo a ms 


EXP (exponen tia!) [aay 


Gives e* which is the natural exponential function of X. 


[) FORMAT 
EXP(X) 


Xx Numeric type constants, variables, array variables, their 


expressions below 145.06286085862 
Given value Floating-point type 


@e (2.7182818284588) is the base of a natural logarithm 
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CO FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRINT EXP¢168> 
2.6881171418087E+43 


1X 13) SERS: Aiea RI ake 


Gives the integer of numeric data 


(1) FORMAT 
FIX(X) 
x Numeric type constant, variables, array variables, their expres- 
sions. 
Given value Numeric type 


(1) FUNCTION AND UTILIZATION 


Gives the value of numeric data X in which the figure below the decimal point is truncated 


EXECUTION EXAMPLE 


PRINT FIXCSOSFIAC-S0SFIRC3.5895F1 


%(-3.58) 
i 


ME FOR-NEXT (for-next) is 


Repeats program execution between a FOR statement and a corresponding 
NEXT statement 


(1 FORMAT 
FOR variable = initial value TO end value (STEP increment] 


NEXT [variable] 


Variable [Cond] Numeric type. FOR statement vartables shall be the same 
as those in the NEXT statement 
Initial value, end value} Cond.| Numeric type constants, variables, and their expressions. 


Increment Cond Numeric type constants, variables, their expressions 


Omit 1 


() FUNCTION AND UTILIZATION 


A program between a FOR statement and a NEXT statement is repeatedly executed while 
the value of the variable specified in the FOR statement is increased from an initial value 
to an end value. The value of the variable is increased by a specified amount each time pro- 
gram execution is terminated 


@ Although the variable in the NEXT statement can be omitted, the correspondence between 
FOR and NEXT can be easily understood in a program list if it is written 
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EXECUTION EXAMPLE 


16 FOR I=16 TO 5@ STEP 18 
26 PRINT "I="31 
3@ NEXT I 


This program is executed as follows. 


| iet0 | Assign 10 linitiat value! to variable t 


Execution transfers to the statement 
after the NEXT statement 


Executes statements between the FOR! 
jand NEXT statements 


Adda 10 to variable | 


Multi-loop , 
A FOR — NEXT loop can be placed inside a FOR — NEXT loop. In this case, the inner loop 
must be completely included inside the outer loop, A different variable is used for each loop. 


14 FOR I=1 TO 5 


26 FOR J=1 TO a 
3@ PRINT "«"3 Inner loop Outer loop 
4@ NEXT J 

5S@ PRINT 

66 NEXT I 

RUN 

* 

OK 

EK 

KR EE 

Be i 


Several FOR statements can be terminated by one NEXT statement. In this case, the variable 
name cannot be omitted in the NEXT statement. Variables are arranged sequentially with the 
inner loop first by punctuating them with commas. 


FOR I=@ TO 16 
FOR J=@ TO 5 


NEXT Jy 1 


—85- 


@ TT 


CE SRDS SIS i tee aaa ie eam 


Gives the number of bytes in an unused area of memory which can be used in 
MSX-BASIC 


CO FORMAT 
FRE(X) 
FRE(” ‘) 
x [Cond Arbitrary numeric value 
Given value Integer type 


() FUNCTION AND UTILIZATION 


FRIWNT FRE¢ " a" ) _ Displays the number of bytes in an unused area of 
memory 


F FE I HT FRE fuuy Displays the number of bytes in an unused part of a char 
: a . acter string area in memory 


SRE COS 0S ES RE TE aT 


(go to subroutine-return) 


Transfers execution to a specified subroutine 
The RETURN statement indicates the end of the subrotitine in which execution 
is returned to a location next to GOSUB or to a specified line number 


() FORMAT 
GOSUB line number 


RETURN [line number] 
Line number Cond.| Integers from 0 to 65529 


[Omit | When omitted in a RETURN statement, it is the line 
number next to the GOSUB statement 
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(1 FUNCTION AND UTILIZATION 


100 GOSUB 1900 


208 GOSUB 1000 


300 GOSUB 10900 


1a00 ° 


SUBROUTINE 


1100 RETURN 


100 GOSUB tone 
200 GOSUB 2000 
1900 * SUBROUTINE 
1100 RETURN 

2000 * SUBROUTINE 


2100 RETURN 


Main routine 


Subroutine 
100 ae 
1000 
| | a 
1 Fi 
' 
| {41100 
300 F terre 


1 


> 200 ———*/2000 
ice 2100 


a 


« 


—87-— 


Calls one subroutine by a plural number of |G 
GOSUB statements. 


Main routine Subroutine 1 


100 T | 1000 
1100 


Subroutine 2 


A plural number of subroutines are placed 
in one program. 


1888 ” 


1058 GOSUB 2000 


1100 RETURN 


2haa ’ 


SUBROUTINE 2 


SUBROUTINE 1 


Main routine 


2108 RETURN 


GOSUB statement multiplexing performance depends on the existing memory 


Subroutine 1 


100 1000 
| | 1050 
1100 


Calles another subroutine from one subroutine 
(GOSUB statement multiplexing.) 


Subroutine 2 
2000 


2100 


BE O00 (C0 0) INT mi 


Transfers program execution to a specified line number 


[) FORMAT 
GOTO line number 


Line number 


[ Cond.| Integers from 0 to 65529 


(J) FUNCTION AND UTILIZATION 


Program execution is transferred to a line specified by a GOTO statement 


@ When executed in the direct command mode, execution starts from a specified line 
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HEX$ (hexadecimal dollar) is 


Gives hexadecimal expression of numeric data as string type data 


CO) FORMAT 
HEXS(X) 
x [Cond. ] Numeric type constants, variables, array variables, their 
— expressions from —32768 to 65535. In the case of nega 
tive numerals, their value is the same as if it is added to 
65536 
Given value String type 


() FUNCTION AND UTILIZATION 


PRINT HEX$¢18@) 
64 

PRINT HEX$¢-32768) 
Baa8 


PRINT HEX$¢255) 
FF 


GE IF -THEN-ELSE (if-then-else) ia 


Branches execution according to the values of an expression, 


C1) FORMAT 
IF expression THEN statement [ELSE] statement] 

Expression [Cond A relational expression for which the result becomes a 
numeric expression, logical expression, or arithmetic 
expression. 

ELSE staternent Omit To the statement after THEN if the expression value is 


true, and to the next line if it is false 


C) FUNCTION AND UTILIZATION 


If the value of an expression is true (except 0), the statement after THEN is executed and if 
the value of an expression is false (O), the statement after ELSE is executed. Then execution 
is transferred to the next line. 


@When the ELSE statement is omitted, the statement after THEN is executed if the expres 
sion value is true. If it is false, the statement after THEN is ignored and execution is trans- 
ferred to the next line 


@ In the IF — THEN GOTO format, THEN or GOTO can be omitted 


IF A=O0 THEN 30 


IF A=0 GOTO 30 Same meaning 
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The statement or line number comes after THEN. 
The line number comes after GOTO 


@ When the GOTO statement comes after ELSE, GOTO can be omitted. 
@When a plural number of statements are written after THEN or ELSE, they are executed 
sequentially with the left statement first. Statements shall be punctuated with a colon (:) 


EXECUTION EXAMPLE 


18 INPUT A 

26 IF A=@ THEN PRINT "ABS="3A E 
LSE PRINT "ABS="3-A 

34 GOTO 148 


Input value of A 


Yes (true) t Display character “ABS=" 


ard valueof A 


No | false) 


and value of —A 


Display character “ABS«" 


IF — THEN statement multiplexing 


IF — THEN can be continued after THEN or ELSE. Multiplexing can be performed within the 
range of one line. 


(Gis INKEY$ (inkey dollar) 


Gives the character of a depressed key, and a null string if no key is pressed 


() FORMAT 


INKEYS 
Given value String type 


() FUNCTION AND UTILIZATION 


When keys other than [CTRL] + (STOP], SHIFT), and| CTRL |are pressed, their character is 


given as data. If no key is pressed, a null string is given. 


EXECUTION EXAMPLE 


if ELS 

26 PRINT "Press any key." 

38 KE=INKEEYS epeats until a key is pre 
44 IF K#="" THEN GOTO 30_| EE, Me 
38 PRINT K#3 

68 GOTO 36 


When any key is pressed, the character is assigned to variable K$ and displayed on the screen 
in line 50 


ae 


Reads data of a specified |/O port 


© FORMAT 
INP(port number) 


Port number [Cond.] Numeric type constants, variables, array variables, their 
expressions from 0 to 255 


(1) FUNCTION AND UTILIZATION 


Inputs and gives data from a specified 1/O port. 
See page 164 for I/O port allacations 


ER 1 a eT 


Inputs the value of a variable from the keyboard 


C1 FORMAT 
INPUT [prompt statement”;] variable [, variable) [, variable] .... 
Variable [Cond | Numeric type, string type, their array variables 
“Prompt statement” [Cond] Comment statement for data input 


[Omit Displays only ‘'?" without a prompt statement 


[] FUNCTION AND UTILIZATION 

Inputs data from a keyboard and assigns it to a variable. At that time, the space before the 

data is ignored 

@ For an INPUT statement of a numeric type variable, the space in the middle of data is also 
iqnored 

@When a comma is input, it is considered to be punctuation tor data, and the items betore the 
comma are considered to be one data assigned to a variable while the comma is not assigned 

eWhen a prompt statement is written, it is displayed on the screen when data input is re 
quested. If a prompt staternent ts omitted, only ''?” is displayed 


@ The number of variables must be in accord with the data 
EXECUTION EXAMPLE 


16 INPUT A | 
R At e| 


— When the prompt statement is omitted 


16 INPUT "A=" 
FR u i —When the prompt statement is used 


@ INPUT "A AND B "3ALB- 


Since the input data is less than the 
number of variables, the missing data 


q AND B ? Fi f iS requested by ?? 
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16 INPUT "A*AND B "3AZB Display when more data is input than 


RL H the nurnber of variables. 


(Residual data is ignored.) 
A AND B ? 1,2,3,4 
Extra ianored 


Eis INPUTS (input dollar) 


1. Inputs a specified number of characters from the keyboard. 
2. Inputs a specified number of characters from a file 


C) FORMAT 


1. INPUTS(X) 
2. INPUTS(X, [#] file number) 


x Cond.| Numeric type constants from variables, array variables. 
their expressions from 1 to 255. 

File number Cond.| 1 < file number < numeral specified by MAXFILES= 
statement 

Given value String type 


() FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


16 X$=INPUT#¢S3 
2@ PRINT X# 


When line 10 is executed, keyboard input wait occurs. After 5 characters are input, they are 
assigned to variable X$. Characters are not displayed on the screen during keyboard input 


14 OPEN "CAS: TEST" FOR INPUT AS #1 


26 X$=INPUT#(58, #12 

36 CLOSE 
In this program, 50 characters are input from a file saved on cassette tape and are assigned to 
string variable X$. Then the file is closed 


Range of “"X” 

During initial status, if X is outside a range from 1 to 200, an error occurs. When the size of 
the character area is set to more than 255 by a CLEAR statement, a value from 1 to 255 can 
be selected 
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GE INPUT # (input number) as 


Reads data from a file opened by an OPEN statement, and assigns it to a variable 


[) FORMAT 
INPUT# file number, variable [, variable] .... 
File nurnber Cond.}| 1 < file number < numeral specified by MAXFILES= 
statement. 
Variable Cond.| Numeric type or string type, their array variables. 


() FUNCTION AND UTILIZATION 
Reads data from a file, If the data is numeric, the space, the return code, and the line feed 


code before the data are ignored. 
If the data is string type, the data from the first character to the character before the space, 


comma, return code, and line feed code is read as one data. If the characters are inside" " 
only these characters are read as data. 


EXECUTION EXAMPLE 
10 OPEN "CAS!TEST" FOR INPUT AS #1—Qpensa file for 
20 IF EOF(1) THEN GOTO 5a | 
3@ INPUT #1,A$:PRINT A$—— Reads data, assigns it to variable AS 
44 GOTO 20 ss 
5@ CLOSE #1 


(See page 42 for File processing.) 


INSTR (in string) 


Retrieves a specified character string from among character strings and gives its 


location. 
© FORMAT 
INSTR([N,} X$, YS) 
N Cond.| Numeric type constants, variables, array variables, their 
expressions from O to 255. 
x$, Y$ String type constants, variables, array variables, their 
expressions. 
Given value: Integer type. 


() FUNCTION AND UTILIZATION 


Gives the number of a character from the left where Y$ starts in an X$ character string as 
numeric data. When N is specified, retrieval starts from Nth character of the X$ 


EXECUTION EXAMPLE 
PRINT INSTRC3, "WHAT IS THIS?"," 1S") 
6 


@When the N value is larger than the length of X$ or X$ is a null string, or if Y$ cannot be 
found, 0 is given 
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INT (te | RES a aS SaaS Ieee 


Gives the maximum integer value smaller than given numeric data 


(1) FORMAT 
INT (X) 
x Cond Numeric type constants, variables, array variables, their 
expressions 
Given value Numeric type 


O FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 
PRINT INTC39$3 INTC-393 INTC3.5893 INT(-3.589 


rey -3 3 -4 


GE INTERVAL ON (interval on i 
INTERVAL OFF (interval off) 


INTERVAL STOP (interval stop) 


Validates, invalidates, or holds an interrupt with a built-in timer 


() FORMAT 


INTERVAL ON — Interrupt valid. 
INTERVAL OFF — Interrupt invalid. 
INTERVAL STOP — Interrupt hold. 


FUNCTION AND UTILIZATION 

A command that actually validates (INTERVAL ON), invalidates (INTERVAL OFF), or 
holds (INTERVAL STOP) an interrupt after declaring an interrupt with a built-in timer by 
using ON INTERVAL GOTO 


(See page 50 for Interrupts.) 


EE oy) TT RES 


Defines a character string for a function key 


(1 FORMAT 


KEY function key number, character string 
Function key number | Cond | Integers from 1 to 10. 


Character string [ Cond] String within 15 characters 


() FUNCTION AND UTILIZATION 
When characters are defined for a function key, a defined character string is entered by just 
pressing a function key. 
® Function keys from 1 to 5 correspond to | F1| — LF5], while numbers from 6 to 10 cor- 
respond to the pressing of each function key while pressing the |SHIFT| key 


@ When the reset button is pressed or the power is turned off, the function key definitions are 
erased and initialized. 


@A code other than that for a character (such as return code) can be defined by using the 
CHR$ function. 


EXECUTION EXAMPLE 
KEY 1," JAPAN" —— 


Defines “JAPAN” for[F1] 


KEY 2,"CLS"+CHR$¢ 1.3 3 ————petines CLs [RETURN] for [F2] 


GS KEY LIST (key list) 


Displays the content of the function keys. 


C) FORMAT 
KEY LIST 


C) FUNCTION AND UTILIZATION 
When this command is executed, the character string content defined for each function key 
is displayed 


EXECUTION EXAMPLE 
Pou o An example of the Initial state. It is found that ‘color 
KEY LIST 15, 4, 4" is defined for the function key 6 (or the 
color key pressed together with the [SHIFT] key) 


run 
color 15:4,4 
cload" 
cont 
Lists 
run 


MN KEY ON, KEY OFF (key on, key off) 


Displays or erases the content of a function key 


CL) FORMAT 
KEY ON or KEY OFF 
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mA 


1 FUNCTION AND UTILIZATION 


Initially the character strings defined for each function key are displayed with 5 characters on 
the last line of the screen. Execute KEY OFF to erase this display 


@ Characters can be output on this line with a PRINT statement after using KEY OFF to erase 
the display 


® Execute KEY ON to output this display. 


WEEE KEY (n) ON (key (n) on) 
KEY (n) OFF (key (n) off) 
KEY (n) STOP (key (n) stop) 


Validates, invalidates or holds a function key interrrupt 


CO FORMAT AND FUNCTION 


KEY. (function key number) ON = — Interrupt valid. 
KEY (function key number) OFF — Interrupt invalid. 
KEY (function key number) STOP — Interrupt hold. 


Function key number Constants, variables, array variables, their expressions 
from 1 to 5 


C] FUNCTION AND UTILIZATION 


Specifies a function key used for an interrupt with a function key number. 


KEY ¢1> ON t—— validates an[F1] key interrupt 
KEY¢2) OFF-— = Invalidates an [F2] key interrupt 


KEY<3) STOP 


(See page 50 Interrupts.) 


—Holds an[ F3] key interrupt 


LEFTS (left dollar) 


Gives an arbitray number of characters taken from the left of string data as string 
data, 


C1) FORMAT 
LEFTS(XS, N) 
X$ Cond.] String type constants, variables, array variables, their 
~ expressions 
N Cond. | Numeric type constants, variables, array variables, their 


expressions from 0 to 255 
Given value String type 
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OC FUNCTION AND UTILIZATION 
PRINT LEFT$¢"MSX-BASIC", 3) 


MS 
Ok 
PRINT LEFT#¢"MSX-BASIC">3.8> 
MSM —— If N is not an integer, 
Ok numbers below the 
4 decimal point are 
omitted. 


PRINT LEFT#¢"MNSX-BASIC",@) 


If N is 0, a null string is 
given, 


Ok 


LE [oth | RRDIMGRRE es ee eee 


Gives the number of characters (length) of character data as numeric data. 


[ FORMAT 
LEN(X$) 
x$ String type constants, variables, array variables, their 
expressions 
Given value Integer type 


© FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRINT LENS "CHRISTMAS" ) 
q 


the space is counted as 1 character 


PRINT LEH "THE END") —_ a character string includes a space, 


@ Also, when a character string includes the CHR$ function. it is counted as one character 


67. 


2 A 


Assigns data for a variable 


Oo 


CO) 


FORMAT 
[LET] variable = X 
Variable [ Cond. | Numeric type, character type variables, array variables 
x [Cond ] Numeric type, character type constants, variables, array 
° ~ variables, their expressions 
FUNCTION AND UTILIZATION 


Assigns a value on the right to the left 
® For string type constants, they are enclosed inside quotation (") marks 
®@ LET can be omitted 


@When a certain type of numeric data is assigned to another type of numeric variable, the 
numeric data is converted to that type of variable 


EXECUTION EXAMPLE 
LET N=N+1————— Increases the value of N by 1 


Ax=45.62PRINT AX 


. ____ Since numeric type data was assigned to a string type 
JPe mlsma t c h variable, an error occurs 
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SS NE nc) Sa ea 


Draws a straight line or square on the foreground in the graphic mode. 


CO FORMAT 
LINE [[STEP] (starting point coordinates)) - [STEP] 
(end point coordinates), [color] Bes 
Starting point Cond.}| Numeric type constants, variables, array variables, their 


expressions frormn —32768 to 32767. 


Last location specified by the last graphic instruction 
[Cond | 


coordinates 


End point Numeric type constants, variables, array variables, their 
coordinates expressions from —32768 to 32767. 
Color Integers from 0 to 15 


Omit Current foreground color 


B, BF Draws a straight line 
C) FUNCTION AND UTILIZATION 


Draws a straight line that connects starting point and end point coordinates (when B, BF is 

omitted) 

e@When "B” is specified, draws a square with a straight line that connects two specified points 
as a diagonal. 

@When “BF” is specified, draws a square with a straight line that connects two specified 
points as a diagonal, and colors the surrounding area 


@ See page 29 for STEP specifications 
EXECUTION EXAMPLE 


1@ CLS 
26 SCREEN 2 
'-(€168,1009,1,6 
C1 


3@ LINE (66,68) 
46 LINE STEP‘-18,+18)- 
38 GOTO 58 
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GS LINE INPUT (line input) 


Gives a string with up to 254 characters by keyboard input as a string type vari- 
able. 


O FORMAT 
LINE INPUT [prompt statement”;] variable 


“prompt statement” [Cond Comment statement for data input 
en) 


[Omit Displays only "2?" without a prompt statement. 
variable [Cond ] String type variables, array variables 
(J FUNCTION AND UTILIZATION 


A return code is only considered as data punctuation, and assigns a keyboard input character 
String to a variable. When a comma is included in a character string, it is assigned as part of the 
character string. 


EXECUTION EXAMPLE 


16 CLS 

26 LINE INPUT "NAME,PHONE? "3N¢ 
36 PRINT N# 

RUN 

NAME, PHONE? JACK, 86-11-22 

JACK: 66-11-22 


BH LINE INPUT# (line input number) Ea 


Reads a string with up to 254 characters from a file, and assigns it to a character 
type variable 


[1 FORMAT 
LINE INPUT # file number, variable 
File number Cond 1 < file number < numeral specified by MAXFILES= 
_____ Statement. 
Variable [ Cond. | String type variables, array variables 


C] FUNCTION AND UTILIZATION 
Reads string type data from a file. However, a space, comma, and line feed code are not 
considered as punctuation for data, which differs from the INPUT# statement, and the 
character string that includes these items is assigned to a variable as character string data. Only 
the return code is considered to be punctuation for data. 


EXECUTION EXAMPLE 
14 OPEN "CAS: DATA" FOR INPUT AS #1 
26 IF EQF¢i> THEN GOTO 66 
38 LINE INPUT :#1,A4 
46 PRINT AF 
38 GOTO 28 
68 CLOSE #1:END 


When a file has been prepared by the following procedure with a file name called DATA. 
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PRINT #1, "ABC"s","3 "DEF" 
PRINT #1,"GHI JKL"S 
PRINT #1, "MNO" 

PRINT #1,"PQR" 


and when this data is read by the above program and displayed on the screen, it is found that 
it was read as 3 string type data as follows. 


ABC, DEF 
GHI JKLMNO 
PQR 


i 


Displays a currently stored program list. 


CO) FORMAT 
LIST [starting line number] [—] [end line number] 


Starting line number Integers from O to 65529, 

Omit | Smallest line number. 

End line number Cond.| Integers from 0 to 65529. 

Omit Largest line number. 

C) FUNCTION AND UTILIZATION 
Press [STOP] to temporarily stop the screen display. Press| STOP] again to resume it again. 
Press and [STOP] to suspend it. 
EXECUTION EXAMPLE 


L I ST Displays all lines. 
L I ST 46 Displays line 40. 
LIST 26-44——_____ — Displays lines from line 20 to line 40 
c Sf i 5 
LIST pal Displays lines from the starting line to line 50 
LIST 34@- Displays lines from line 30 to the end line 
The last line displayed by a LIST statement or 
L I ST = ————_— a line with execution interrupted by an error is 
displayed 
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HE LLIST (line printer list out) iii 


Prints a currently stored program list with a printer. 


1 FORMAT 
LLIST [Starting tine number] [—] [end line number] 


Starting line number {| Cond Integers from 0 to 65529. 
Omit Smallest line number. 
End line number Cond.| Integers from 0 to 65529. 


Omit | Largest line number. 
C) FUNCTION AND UTILIZATION 


Specification is the same as that for a LIST statement. A list is not displayed on the screen 
during the execution of an LLIST statement. 
elf an LLIST statement is executed when a printer is not connected or when a printer is not 


operational, the computer_stops without accepting keyboard input. If this occurs, input is 
accepted by pressing the (ETRL] and [STOP] key at the same time. 


SERS 0 | onc) REN emma 


Loads a BASIC program file into memory from a specified device. 


1) FORMAT 
LOAD “device name [file name] ” 
Device name Cond.| CAS: ... Cassette tape. 
File name String within 6 characters. If 7 or more characters are 


specified, the 7th character and after are ignored. 


[ Omit Loads the file found first. 
[] FUNCTION AND UTILIZATION 


When CAS: is specified as a device name, a program saved by an ASCI| format on a cassette 
tape by SAVE “CAS: file name" is loaded 


EXECUTION EXAMPLE 


LOAD "CAS!:PROGE" 
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GE LOCATE (locate) as 


Moves the cursor to a specified location 


C) FORMAT 
LOCATE [X-coordinate] , [Y-coordinate] , [cursor switch] 
X coordinate [Cond] Numeric constants, variables, array variables, their expres 
sions from O to 39 
LOmit; 9 
Y coordinate ‘Cond. Numeric constants, variables, array variables, their expres- 
_._ sions from O to 24. 
[Omit] 0 
Cursor switch [Cond. 0... Cursor is not displayed, 
1... Cursor is displayed. 
[Omit | 1 


C) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 
1@ CLS 
20 LOCATE 12,16 
3Q PRINT "ska" 


(0, 0) 12 


LOG (natural logarithm) 


Gives the value of a natural logarithm (Log e). 


() FORMAT 
LOG(xX) 
x [Cond] Numeric constants, variables, array variables, their expres- 
sions larger than 0. 
Given value Numeric type. 
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(| FUNCTION AND UTILIZATION 
The LOG function gives the value of a natural logarithm in which the base is e 
(2.7182818284588). 


@ The value of a logarithm Logab (b >0), in which a is the base that is a positive numeral 
(a# 1), can be obtained by LOG(b)/LOG (a) 


EXECUTION EXAMPLE 


PRINT LOG(18) 
2, 382585092994 


LPOS (line printer position) iii 


Gives the print head location in the printer buffer 


CO) FORMAT 
LPOS(X) 
x An arbitrary numeral (dummy argument) 
Given value: Integer type 


CO) FUNCTION AND UTILIZATION 
Gives the location of a character currently being printed out to the printer in the line printer 
buffer memory. (Start=0) 


GE LPRINT (line print 


Outputs the value of an expression to the printer 


O FORMAT 
LPRINT [expression] [separater] [expression] [separater] [expression] .... . 
Expression Numeric and string constants, variables, array variables, 


their expressions 


Line feeds 


Separater ,or; 
(1) FUNCTION AND UTILIZATION 


An LPRINT statement outputs data to a printer while a PRINT statement outputs data to the 
screen. See PRINT for details 


GE LPRINT USING (line print using) 


Outputs data to a printer in a specified format 


O FORMAT 
LPRINT USING format symbol; expression [expression] ..... 
Expression String and numeric constants, variables, array variables, 


their expressions 
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1 FUNCTION AND UTILIZATION 


LPRINT USING outputs data to a printer in a specified format while PRINT USING outputs 
data to the screen in a specified format. See PRINT USING for details such as those for 
format symbols 


GE MAXFILES (maxfiles) ay 


Declares the number of files that can be simultaneously opened in one program 


1) FORMAT 
MAXFILES = expression 
Expression Cond] Numeric type constants, variables, array variables, their 


expressions from O to 15. 


(1) FUNCTION AND UTILIZATION 


Declares the number of files that can be simultaneously opened in one program. Opening 
files simultaneously means to open a file and open another file before closing the former, 


EXECUTION EXAMPLE 
16 MAXFILES=3 
26 OPEN "GRP:"FOR QUTPUT AS #1 
3@ OPEN "CRTS "FOR QUTPUT AS #2 
44 OPEN "LPT? "FOR QUTPUT AS #3 


1000 CLOSE 


Since 3 was selected as the number of files that can be opened in line 10, 3 files can be 
opened in line 20 and after 

When the number of files is not specified by a MAXFILES = statement, only one file can be 
opened at one time 

@ |f a large value is unnecessarily declared, the user area becomes smaller 


EE MERGE (merge) 


Loads a program saved by an ASCII format, and merges it with a program in 
memory 


C) FORMAT 


MERGE “‘device name [file name] ” 


Device name CAS: . . . Cassette tape. 


File name String within 6 characters. If 7 or more characters are 
specified, the 7th character and after are ignored. 
Omit | Merges the first file found. 
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O FUNCTION AND UTILIZATION 


Only CAS: can be specified as a device name. Loads a program saved on cassette tape in an 
ASCII format by a SAVE statement. The existing program in memory, maintained as it is, is 
merged with the program loaded by a MERGE statement. 


@ \f the line numbers of the program loaded by a MERGE statement are the same as that of 
an existing program in memory, the line numbers of the program newly loaded by a 
MERGE statement are maintained. 


EXECUTION EXAMPLE 
MERGE "“CAS:PROG3" 


MIDS (middle dol 2r) 


Fetches and gives a part of character data. 


1 FORMAT 
MID$(X$, M [, N] 
X$ Cond.| String type constants, variables, array variables, their 
expressions. 
M Numeric type constants variables, array variables, their 


expressions from 1 to 255. 


N Cond.| Numeric constants, variables, array variables, their expres 
sions from 1 to 255 


[Omit Gives all characters after the Mth character 
Given value: String type. 


CO) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRINT MID$¢" JAPANUKFRANCE", 6,2) 
UK 


fi. INT MID$<" JAPANUKFRANCE">6,2.6) 
UK 


value, figures below 
the decimal point are 


| If N is not an integer 
omitted. 


PRINT MID#¢"JAPANUK">6,4 >} si hain a not exist after the 


all characters after 
UK the Mth character are given. 


PRINT MID#¢"JAPANUK", 12,5) 


When the value of M is larger 
— than the length of X$ or when 


PR INT 4 I DSc " JAPANUK "y ‘. ad N is 0, a null string is given. 
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EE MIDS = Y$ (middle dollar) 


Replaces a part of a character string with another character string. 


CO) FORMAT 
MIDS(XS, M[, N]) = Y$ 
x$, Y$ Cond.] String type constants, variables, array variables, their 
~ expressions 
M Numeric type constants, variables, array variables, their 
: expressions from 1 to 255. 
N Cond.| Numeric type constants, variables, array variables, their 


expressions from 1 to 255 
Omit | Mth character and after in X$ are replaced by Y$. 


() FUNCTION AND UTILIZATION 


Replaces the Mth character and after from the left in the X$ character string with the char- 
acters from the beginning to the Nth character in Y$. However, the length of X$ is not 
changed after execution 


EXECUTION EXAMPLE 


16 X$="ABCDEFG" 
26 Ys="ORSTUYI 
36 MIDFCK$. 4, 29=4 
44 PRINT XK¥ 

RUN 

ABCORFG 


E00 >) ae ae 


Turns the motor of the cassette tape recorder on and off. 


Alt 
cS 


() FORMAT 


MOTOR [(on} 


[1 FUNCTION AND UTILIZATION 


Connect the computer TAPE terminal to the remote control terminal of a cassette tape 
recorder and place the recorder in a playback or record mode. Tape operation starts with 
MOTOR ON and stops with MOTOR OFF 

When only MOTOR is executed, if it is ON, it is switched to OFF, and if it is OFF, it is 
switched to ON 
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FARR NE (1008) RAR: a 


Erases a BASIC program in memory and clears variables. 


CO) FORMAT 
NEW 
[ FUNCTION AND UTILIZATION 


NEW is executed before entering a new program to erase all previous programs and enter a 

command wait state 

@When a machine language program exists in memory, it is maintained even if NEW is ex- 
ecuted. 


EME OCTS (octonary dollar) 


Gives an octal expression of numeric data as string type data. 


CO FORMAT 
OCTS(X) 
x Cond.] Numeric type constants, variables, array variables, their 


expressions from —32768 to 65535. If it is a negative 
numeral, it is the samme as a value in which the value is 


added to 65536 
Given value String type 


QO) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRINT OCT$¢100) 
144 


PRINT OCT#$(65536-32768) 
166686 


GE ON ~ ERROR GOTO (on error go to) a 


When an error occurs, execution is transferred to a specified line number 


0 FORMAT 
ON ERROR GOTO line number 
Line number Cond.] Integers from 0 to 65529 


OO FUNCTION AND UTILIZATION 
Used to prevent an execution interruption caused by an error that occured during program 
execution. When an error occurs after ON ERROR GOTO is declared, execution is trans- 
ferred to a specified line number. (Also, when an error results from a direct command, ex- 
ecution is transferred to a specified line number.) 
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EXECUTION EXAMPLE 


16 ON ERROR GOTO 186 

26 INPUT A 

38 B=SQRCAD END statement that distinguishes a main 
46 PRINT "SORCAI="3B routine from the error processing routine. 
58 END ] 

166 IF ERR=5 AND ERL=30 THEN PRIN Error processing 
T "Input a Positive number." ~~ routine. 

116 RESUME 26 


To invalidate an ON ERROR GOTO statement 
Execute ON ERROR GOTO 0. 


GE ON-GOSUB (on-go to subroutine) aa 


Branches program execution to subroutines that start with specified line numbers 
depending on the value of the expression. 


CO FORMAT 
ON expression GOSUB line number [, line number] .. . 
Expression Numeric type variables, array variables, their expressions 
from 0 to 255. 
Line number Integers frorn 0 to 65529, 


1] FUNCTION AND UTILIZATION 
166 ON & GOSUB 586,600,786 


In this program, if the value of X is 1, execution branches to a subroutine from line number 
500, and if the value of X is 2, execution branches to a subroutine from line 600, and if it is 
3, execution branches to a subroutine from line 700. 

A return to the main program is accomplished by a RETURN statement. 

Expression value and execution result 

When the expression value is not an integer .. . Figures below the decimal point are omitted. 
When the expression value is 0 or larger than the number of the line number specified by 
GOSUB ... Transferred to a statement next to the ON — GOSUB statement. 

When the expression value is negative or larger than 255 .. . An error occurs. 
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EEE ON-GOTO (on-go to) 


Branches program execution to line numbers that depend on the value of an 
expression. 


O FORMAT 
ON expression GOTO line number [, line number] .. . 
Expression [Cond-] Numeric type variables, array variables, their expressions. 
Line number [Cond.] Integers from 0 to 65529 


CO) FUNCTION AND UTILIZATION 
166 ON * GOTO 120,130,186 


In this program, if the value of X is 1, it branches to line 120, if it is 2, it branches to line 130, 
and if it is 3, it branches to line 180 


Expression value and execution result 

When the expression value is not an integer . . . Figures below the decimal point are omitted. 
When expression value is O or larger than the number of line numbers specified by GOTO .. 
Transferred to a statement next to the ON — GOTO statement 

When the expression value is negative or larger than 255 .. . An error occurs 


ME ON INTERVAL GOSUB RE 
(on interval go to subroutine) 


Declares a subroutine to which program branches when an interrupt is caused by 
a built-in timer. 


O FORMAT 
ON INTERVAL = Interval time GOSUB line number 
Interval time Cond.| Numeric type constants, variables, array variables, their 
expressions from —32768 to 65535 and other than 0 
Line number Cond Integers from 0 to 65529. 


1 FUNCTION AND UTILIZATION 


A statement that declares a subroutine starting line number to which program branches when 
an interrupt is caused by a built-in timer with a certain interval. The interrupt spacing is about 
(interval time x 1/50) second. In other words, when the interval time is specified as 50, an 
interrupt occurs approximately every (See page 50 for Interrupts) 
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EXECUTION EXAMPLE 


16 ON INTERVAL=56 GOSUB 106 
26 INTERVAL ON 
36 SCREEN 2,1 


46 SPRITE$(1)=CHR$(&H18)+CHR$(&H3 CI+CHRE 


(&H66)+CHR$¢ &HDB) +CHR$(&HE7D+CHRECRHTED + 
CHRS<&H249+CHR$CRH42) 


56 GOTO 5@ 

166 X=INTCRND¢C1)*256):V=INTCRNDC1 #192) 
116 C=INTCRND¢C1)9#*14)+2 

126 PUT SPRITE 1,¢%,¥),C)1 

139 RETURN 5@ 


In this program, an interrupt occurs with about 1 second spacing provided by lines 10 and 20, 
and each time interrupt occurs, the execution is transferred to a subroutine from line 100. 


After a UFO shaped sprite pattern is displayed by this subroutine, a return to line 50 occurs 
caused by RETURN 50. 


@When the interval time is set to a negative numeral, it is equal to a numeral in which the 
specified interval time is added to 65536. 


GER ON KEY GOSUB 


(on key go to subroutine) 


Declares a subroutine to which program branches when an interrupt is applied by 
a function key. 


OC FORMAT 
ON KEY GOSUB line number [, line number] .. . 
Line number Cond] Integers from 0 to 65529. 


[) FUNCTION AND UTILIZATION 


A statement that declares the starting line number of a subroutine to which program branches 
when an interrupt is applied by a function key. Up to 5 line numbers can be specified after 
GOSUB by punctuating them to sequentially correspond to[F 1], [F2], etc. 

EXECUTION EXAMPLE 


146 ON KEY GOSUB 1660, 2686 
26 KEY¢1) ONS KEY¢3) ON 


When is pressed, execution is transferred to a subroutine from line 1000, and when| F3 


is pressed, it is transferred to the subroutine from line 2000 based on the above two lines of 
the program 


A return from the subroutine is made by a RETURN statement (See page 50 for Interrupts) 


iit 


a On SPRITE GOSUB (on sprite go to subroutine) il 


Declares a subroutine to which program branches when an interrupt occurs due to 
a sprite overlap. 


CO FORMAT 
ON SPRITE GOSUB line number 


Line number Integers from 0 to 65529. 
CO) FUNCTION AND UTILIZATION 


A statement that declares the starting line number of a subroutine to which program branches 
when an interrupt occurs due to an overlap of sprite patterns. 


EXECUTION EXAMPLE 
16 ON SPRITE GOSUB 1986 
26 SPRITE ON 


When a sprite overlap occurs, execution is transferred to a subroutine from line 1000 based on 
the above two lines. A return is made froma subroutine by a RETURN statement. 


eS ON STOP GOSUB (on stop go to subroutine) ia 


Declares a subroutine to which program branches when a [CTRL] +[ STOP] key 
interrupt occurs. 


CO) FORMAT 
ON STOP GOSUB line number 


Line number Integers from O to 65529 
[ FUNCTION AND UTILIZATION 


A staternent that declares the starting line number of a subroutine to which program branches 
when a[CTRL] +[STOP] key interrupt occurs. 


EXECUTION EXAMPLE 


16 ON STOP GOSUB 1608 
26 STOP ON 


Execution is transferred to a subroutine from line 1000 by simultaneously pressing [CTRL 
and [STOP] based on the above two lines. A return from the subroutine is made by a RE- 
TURN statement. (See page 50 Interrupts.) 


Precautions 
It is necessary for a program to be terminated somehow when a subroutine Is executed. The 
only way to terminate the following program is to press the [RESET] button, 

16 UN STOP GOSUB 166 

26 STOP ON 

36 PRINT "MAIN ROUTINE" 

48 GOTO 46 

166 PRINT "CTRL+STOP EXECUTED" 

1148 RETURN 36 
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GEE ON STRIG GOSUB (3 to suvrcutne) 
go to subroutine 
Declares a subroutine to which program branches when an interrupt is caused by 
the space bar or the trigger button of a joy stick. 


C1) FORMAT 
ON STRIG GOSUB line number [, line number] . . . 
Line number Integers from 0 to 65529 


C) FUNCTION AND UTILIZATION 
A statement that declares the starting line number of a subroutine to which program branches 
when an interrupt occurs by the pressing of the space bar or joy stick trigger button. Up to 
five line numbers can be specified after GOSUB by punctuating them with commas. 
On STRIG GOSUB line No. 1, line No. 2, line No. 3, line No. 4, line No. 5 


Line No. 1... . Branches when the space bar is pressed 
Oa eae Joy stick 1, Trigger button 1. 
aCe ee Joy stick 2, TPigger button 1. 
Line No. 4 ...... Joystick 1, Trigger button 2 
LING NG.'S «oso Joy stick 2, Trigger button 2. 


EXECUTION EXAMPLE 

16 ON STRIG GOSUB 1888, 2606, 3006 

2@ STRIG(H) ON:STRIGC1> ON'STRIGC2) ON 
When the space bar is pressed, execution is transferred to a subroutine from line 1000, and 
when trigger button 1 of joystick 1 is pressed, execution is transferred to a subroutine from 


line 2000. Also, when trigger button 1 of joystick 2 is pressed, execution is transferred to a 


subroutine from line 3000. : - 
Return from a subroutine is accomplished with a RETURN staternent. (See page 50 for Inter- 


rupts.) 


MBE ON lop 0) RR ee 


Opens a file and specifies a mode 


() FORMAT 
OPEN “device name [file name] FOR mode AS [#] file number. 
Device name Cond.| CAS: .... Cassette tape 
CRT: .... Text mode screen 
GRP: .... Graphic mode screen 
LPT os «3 Printer 
File name String within 6 characters. If 7 of more characters are 


specified, the 7th character and after are ignored 


Null-string 


Mode Cond_] OUTPUT... Write. 
INPUT... Read. 

File number Cond.| 1 < file number < numeral specified by MAXFILES = 
statement 


() FUNCTION AND UTILIZATION 
An OPEN statement opens a file with a specified file number to perform file |/O for a speci 
fied device. Since CRT:, GRP:, and LPT: of the devices that can be specified are dedicated to 
write-in, only OUTPUT can be specified as a mode. On the other hand, since write-in and 
read-out can be performed with CAS:, OUTPUT and INPUT can be specified 
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eWhen write-in is performed with a file name, read-out can be performed by specifying the 
same file narne. 


@ The file number should be equal to or less than the numeral that indicates the maximum 
number of files which can be opened, as specified by MAXFILES = statement. 


EXECUTION EXAMPLE 
16 SCREEN 2 
26 OPEN "GRP!" FOR OUTPUT AS #1 
30 PSET (126,90) 
44 PRINT #1, "ABC" 
56 GOTO 5a 


This is a program that outputs characters on the screen in the graphic mode (SCREEN 2) 
(See page 42 for File Processing) 


SEE OEE He 


Outputs 1 byte data to a specified I/O port 


1 FORMAT 
OUT port number, expression 
Port number, [Cond] Numeric type constants, variables, array variables, their 
expression expressions from 0 to 255 


() FUNCTION AND UTILIZATION 


This is a command that outputs data directly to an 1/O port. See page 164 for |/O port assign- 
ments 


0. SE a Sa 


Provides the status of the touch pad 


() FORMAT 
PAD(N) = 
N [Cond] Integers from 0 to 7 
Given value Numeric type 


() FUNCTION AND UTILIZATION 
Provides various data from a touch pad by an N value. When N is O, 1, 2, or 3, the status of 
the touch pad connected to controller terminal A is provided. When is 4, 5, 6, or 7, the status 
of the touch pad connected to controller terminal! B is given 


Value of N Semantics for a given value 


0: Not touched 
—1: Is touched 


Oor4 


lord X coordinate of a touched location 


2or6 Y coordinate of a touched location 


0: Switch is not pressed. 
3or7 : . 
—1: Switch is pressed 
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Pe 


Colors an area surrounded by a border line. 


CO) FORMAT 
PAINTISTEP] (X-coordinate, Y coordinate), [display color], [border line color] 
X-coordinate [Cond.] Numeric type constant, variables, array variables, their 
expressions from 0 to 255, 
Y coordinate Cond.] Numeric type constants, variables, array variables, their 


expressions from 0 to 191, 
Display color, border |Cond.| Integers from 0 to 15. 


line color 
Current foreground color 
[) FUNCTION AND UTILIZATION 


Colors an area with a display color inside a border line with a specified color including the 
location specified by X, Y coordinates. 
ef the border line is not completely closed, the entire screen is colored. 


@in the SCREEN 2 (high resolution) mode, if the display color is not the same as the border 
line color, the entire screen is colored. 
@ See page 29 for STEP specifications. 


EXECUTION EXAMPLE 


1@ CLS 
26 SCREEN @)- 
39 CIRCLE 
4@ PAINT 
5@ GOTO Se 


In SCREEN 2, the same color 
— must be specified for the display 
color and border line color. 


19 CLS 
20 SCREEN @) - 
3H CIRCLE (70,70),40, 16 
49 PAINT (70,70) 


56 GOTO 58 
cys ga | 


Dark 
yellow 


In SCREEN 33, different colors 
can be specified for the display 
color and border line color 


Medium red 
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GEST PDL (paddle) as 


Gives the value from a paddle 


[1 FORMAT PDLIN) 
PDLIN) 
N [Cond] Integers from 1 to 12. 
Given value Numeric type from 0 to 255. 


(1) FUNCTION AND UTILIZATION 


Gives the value obtained from a paddle as numeric type data. When N is an odd number, 
data is provided from the paddle connected to controller terminal A, and when N is an even 
number, data is provided from the paddle connected to controller terminal B 


PEEK (200 | aaa Sama ee aaa 


Gives the content of a specified memory address 


{J FORMAT 
PEEK (address) 
Address Cond.] Numeric type constants, variables, array variables, their 
. 4 expressions from —32768 to 65535. In the case of nega- 
tive numerals, their value is the same as if it is added to 
65536 
Given value Numeric type decimal format 


L) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


Assigns the content of memory address 50000 to 
variable M 


a O°, Se ee: 


Generates a sound according to a subcomman4d specification 


CL) FORMAT 
PLAY subcommand 


Subcommand Cond. | Character string (constant) inside “ “’, or a string type 
. variable which is assigned a character string. Capitals or 
small characters. 
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Subcommands 


[commend [cordiion [SSCs C*d 
Tn 


Specifies the speed of music. The value of n indicates the 
counting of a quarter note for one minute. The initial 
setting is T120. 


Specifies one of 8 octaves. When O04 is specified, music 
within the range shown below is performed. 


== 


The octave becomes lower as the value of n becomes 
smaller and becomes higher as the value of n becomes 
larger. 

The initial value is 04. 


Specifies the volume variation pattern from among the 
following patterns. 


$=0;1,2;3,9 


eee | ee i 


$=4,5,6,7,15 $=12 


The initial setting is S1. 

The generation of many different sounds is determined by 
a combination of the S subcommand and the M sub- 
command. 


Mn 1 <n < 65535 | Determines the cycle of the pattern specified by the S 
(modulation) subcommand. The cycle becomes long as the value of n 
is increased. 
The initial setting is M255. 
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Ln — Indicates the length of sound. 
(length) 
u1 L2 L4 (8 LI16 L32 L64 
ott ddd 2 
Initial setting is L4. 


Nn Ss Specifies a musical note. 
ote) 
N36 is = NO is a rest. 
The chromatic scale increases as n is Increased by 1. 


(n 
A-—G S Specifies the musical note within a specified octave. 


c#p# F#GHAT 
ct pt Ft Gt at 
D-E7- GA B 


CDEFGASB 


# lor +) and — are used for a sernitone. 
The sound length can be specified by n. (C4 is the same as 
L4C.) When omitted, it is the length specified by Ln. 


Specifies a rest. 


R16 R32 R64 


, 7 J 


Express a dot. 
The length is extended to 1.5 times by placing it by one. 


Vn Ogn<15 Specifies the volume. The volume increases as n becomes 
(volume) larger. The inital setting is V8. 
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O FUNCTION AND UTILIZATION 
PLAY "TSGO3L4CDEFG2.RABO4CDC2." 


Based on the above statement, the sound is played according to the following notes. 


To express a subcommand with a variable 


M$="TSGO3L4CDEFG2.RABO4SCDC2," 
PLAY M$ 


A subcommand is assigned to a string type variable, M$, once, then M$ is specified in a 
PLAY statement as a subcommand. 


To express a part of a subcommand with a variable (X variable;) 


16 M$="CDEFG2.R" 
26 PLAY "O4L4XMN$3 GAGAG2.R" 
36 PLAY "XM$;ABOSCDC2." 


When a subcommand assigned to a string type variable is used in“ “ of a play statement, add 
X before and ; after. In the example above, a subcommand assigned to M$ is used in two 
PLAY statements. 


To express n in a subcommand with a variable (=variable;) 
n which is specified in each subcommand can be a constant or a variable in a PLAY statement, 
When expressed as a variable, = is added before and ; after. 


16 FOR I=1 TO 8 
26 PLAY "O=1;CEG" 
36 NEXT I 


This program plays 8 octave music from PLAY “O1CEG” to PLAY “O8CEG”. 


Performance of chords 
Up to 3 commands can be simultaneously played such as PLAY A$, B$, C$ 


16 Ag=" O4C00360 4E2R4" This program plays the following notes. 


20 B$="04EFDGOR4" 
30 C$="046AG05C2R4" A= 
40 PLAY A$,B$.C$ 
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PLS (D8 | eae Sea ae aa 


Checks if music is being played or not. 


1 FORMAT 
PLAY(N) 
N Integers from 0 to 3. 
Given value Numeric type. 


1 FUNCTION AND UTILIZATION 
Three different sounds can be simultaneously played in a PLAY statement. 
In the case of PLAY A$, BS, C$; 
the sound of subcommand A$ is output from Channel 1, the sound of B$ is output from 
Channel 2, and the sound of C$ is output from Channel 3. 
The PLAY function checks if data is in the music data buffer of Channel 1 when N = 1, the 
same for Channel 2 when N = 2, and the same for Channel 3 when N = 3. When data is in the 
buffer, —1 is given, and when there is no data, O is given. When N = 0, the OR (logical sum) of 
the buffer status (O or 1) of all channels is given. In other words, if one of them is —1, —1 is 
given. 


EXE POINT (point) 


Gives the color code of a point at a specified location in the graphics screen. 


0 FORMAT 
POINT(X, Y) 
iy: Numeric type constants, variables, array variables, their 
expressions from —32767 to 32767. 
Given value: Numeric type (—1 is given when a specified location is 


outside the display area.) 


O FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


16 SCREEN 3: 

26 FOR I=1 TO 256 

36 K=INTCRND¢1)*255) 

46 Y=INTCRND(1)#*191) 

38 PSET ¢X»)>1 

6@ NEXT I 

76 FOR Y=@ TO 191 STEP 4 
86 FOR =@ TO 255 STEP 4 
9@ C=POINTCR,¥) 

160 IF C=4 THEN PSET ¢X»¥),15 
116 NEXT &.¥ 

126 GOTO 126 


The color code for the location (X, Y) is assigned to variable C in line 90, and changed into 
white in line 100 if C is 4 (dark blue) 
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GR POKE (poke) BR ae ae Sara 


Writes data to a specified memory address 


O FORMAT 
POKE address, expression 
Address Numeric type constants, variables, array variables, their 
expressions from —32768 to 65535. 
Expression Cond. Numeric type constants, variables, array variables, their 


expressions from 0 to 255. 


C) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


POKE 58666,255 Writes 255 as data to memory 50000. 


POKE &HDG@GG, &HAB - Writes A8n as data to memory address DOOOn. 


EXE POS (position) a 


Gives the X-coordinate of the cursor position. 


[) FORMAT 
POS(X) 
x Cond} An arbitray numeric value (dummy argument) 
Given value Integer type 


() FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


16 INPUT AF 
20 PRINT As.X=POS¢X) 
3@ IF ®>=5 THEN CL® 
4@ PRINT: GOTO 18 
The value of the cursor X-coordinate is given to the variable X based on line 20, X=POS(X), 


As a result, the screen is cleared by inputting a string with 5 characters or more than 5 char- 
acters for A$. 
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GE PRESET (point reset) 


Marks or erases a dot on the screen in the graphic mode. 


QO 


FORMAT 
PRESETI(STEP] (X-coordinate, Y-coordinate) [, color] 
X, ¥ coordinate Numeric type constants, variables, array variables, their 
expressions from —32768 to 32767 
Color Cond.| Integers from 0 to 15. 
[Omit ] Current background color 
FUNCTION AND UTILIZATION 


When executed with color omitted, a dot is marked with the same color as the background 
color. As a result, if something is drawn at a specified location with a color other than the 
background color, it looks as if a point at the sarne location was only erased. 


@ When a color is specified, it functions exactly the same as when a color is specified by PSET 
@ See page 29 for STEP specifications. 
@ See PSET for a program example 


CORR IN 0 (rt) a eRe SR aaa 


Displays numeric data or character data on the text screen. 


Oo 


ca” 


FORMAT 


PRINT expression [separator] [expression] [separator] [expression] .. . 


Expression Numeric type or string type constants, variables, array 
variables, their expressions. 


Separator Comma (,) or semicolon (;) 


FUNCTION AND UTILIZATION 

Expression (data) writing method 

Numeric type constants, numeric type and string type variables are written as they are, and 
string type constants are written inside quotation marks ("" *’) 

Separator function 

When data is punctuated with a comma |,), spaces by a 14 digit tab function is inserted 
between the data, and when it is punctuated with a semicolon (;), it is followed by the next 
data. 

If a separator is not written at the end, line feed is performed after the data display. If a 
separator is written at the end, data of the next PRINT statement continues on the same 
line without a line feed. 


Numeric data and signs 


In regard to signs that indicate positive or negative, ‘'+"’ is omitted while “—"' is displayed as it 
is. (If a “’;’’ separator is used when positive numeric data is displayed, two spaces are inserted 
between data to provide space for a sign 
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Omitted format 
The same result can be obtained by inputting “?” instead of PRINT. 


EXECUTION EXAMPLE 


10 AS="ABC":B$="DEF" 
20 PRINT ASsBS 

30 PRINT AS.B$ 

4@ PRINT 

54 PRINT "MS" 

64 PRINT +50,-50 

74 ?"PERSONAL COMPUTER" 


RUN 

ABCDEF —— Pass u It ine 20. 

ABC DE F——— Result of line 30. 
Result of line 40. 

MSK Result of line 50. 


50 -58 
PERSONAL COMPUTER 


Result of line 60. 
Result of line 70. 
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HE PRINT USING (print using) 


Outputs data to the screen in a specified format. 


O FORMAT 
PRINT USING format symbol; expression [expression] .. . 
Expression String type and numeric type constants, variables, array 


variables, their expressions. 


CO) FUNCTION AND UTILIZATION 
The value of an expression is displayed in a format specified by a format symbol. 
Format symbols for character type data 


Expression format and Execution example 


Outputs the first 1 character. 


PRINT USING "!"3"United"» "Nation" 
UN 


Outputs n+2 characters. When data is smaller than n +2 characters, 
inserts spaces for the residual characters. 


PRINT USING "\ \"$"ABCDEF","GHI" 
>"JKLMN" 


ABCDGHI JKLM 


Outputs all character strings. 


16 AS="North":Bs="South" 

26 PRINT USING "& Pole "$AF,BS 
RUN 

North Pole South Pole 
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Format symbols for numeric type data 


Expression format and Execution example 


Writes # by the number of numeral digits to be displayed. Decimal 
point is "’.”’, 


PRINT USING "POINT: ###,. #"3123.4 
POINT! 123.4 


@When the number of integer digits is less than the specified # number, 
data is displayed with right justification, and if it is more, "%"' is added 
before the data, 


16 PRINT USING "“####"3 12 
26 PRINT USING “####"3 12345 
RUN 
12 
%12345 


@When the number of digits in a fraction of numeric data is smaller than 
the specified # number, "O" is added, and when it is larger, it is 
rounded to the nearest whole number. 


18 PRINT USING "##.##"325.3 
26 PRINT USING "##, ##"3 25.345 
RUN 

25.368 

25.35 


a ck sign of numeric data is ignored and the ‘‘—"' sign is counted as 
one digit. 

16 PRINT USING "###"3+123 

26 PRINT USING "###"3-123 

RUM 

123 

47123 


"+" is added if it is a positive numeral, and “—"’ is added if it is a negative 
numeral before or after the numeric data. 


14 PRINT USING "+####"3123,-123 
26 PRINT USING "####+"3123,-123 
RUN 

e125 — 12s 

123+ 123- 


“_" is added after negative numeric data. 


PRINT USING "###-"3123,-123 
les i237 
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The space before numeric data is filled with ‘*’’. One “®‘ in the format 
expresses one digit. 


14 PRINT USING "*#######"5123 
26 PRINT USING "“*#######"53-123 
RUN 

eeAKAL OS 

eK 1 OF 


nas “£" before numeric data. One "£" in the format is couted as one 
igit. 

18 PRINT USING "££###"3 1234 

26 PRINT USING "+££###"3-1234 


Adds “£" just before the numeric data, and space before that is filled 
with ser 


PRINT USING "#kE##H. #H"512.34 
##KELD, 34 


When this is specified somewhere before the decimal point, it is dis- 
played by the insertion of commas between each 3 digits to the left 
of the decimal point. 


PRINT USING “#) #8888. ##"5 12345.67 
12,345.67 


Displays numeric data by floating point type. 
“AAAN" corresponds to the digits for exponent part. 


PRINT USING "##. ##°°°*"3 234,56 
2.355E+82 
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GE PRINT# (print number) 


Writes data to a file opened by an OPEN statement. 


[) FORMAT 
PRINT # file number, expression 
File number [Cond 1 < file number < numeral specified by MAXFILES= 
= statement 
Expression [Cond String type and numeric type constants, variables, array 


variables, their expressions. 


C) FUNCTION AND UTILIZATION 


Outputs data to a file opened by an OPEN statement. 
EXECUTION EXAMPLE 


16 OPEN "CAS:DATA" FOR OUTPUT AS #1 ——{Pensaills 
26 FOR 1=6 TO 4 


READ AF 
PRINT #1,A$5","3 Writes data to a file 
NEXT I 
CLOSE #1 
4 DATA TOKYO, LONDON, PARIS; PEKING 
»HEW YORK 
This is a program which sequentially writes data written in line 70 to cassette tape with a file 


name “DATA” 
(See page 42 for File Processing.) 


J On fe ta bs 
cr i oy cS 


sae 
ct 


ME PRINT# USING (print number using) Hi 


Writes data to a file opened by an OPEN statement in a specified format 


[) FORMAT 
PRINT = file number USING format symbol; expression 
File number [Cond.] 1 < file number < numeral specified by MAXFILES= 
statement 
Expression [Cond.] String type and numeric type constants, variables, array 


variables, their expressions, 


() FUNCTION AND UTILIZATION 


This format can be specified when data is output to a file. See PRINT USING for a format 
symbol 
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HRY SET (point set) aa ay 


Marks a dot ona graphic mode screen 


CO) FORMAT 
PSETISTEP] (X-coordinate, Y-coordinate) [, color] 
X, Y coordinates [Cond] Numeric type constants, variables, array variables, their 
aes expressions from —32768 to 32767. 
Color | Cond] Integers from O to 15, 


[Omit Current foreground color 


( FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


16 SCREEN 2 

20 FOR ¥=@ TO 255 
38 PSETCX+1, 168) 

46 PRESET ¢€%, 166 9——— Erases the dot drawn before 
78 NEXT & 


See page 29 for STEP specifications 


P.144 


Draws a dot 


GE PUT SPRITE (put sprite) as 


Displays a specified sprite pattern at an arbitray location on a specified sprite 
plane. 


O FORMAT 


ited ail sprite plane number [[STEP] (X-coordinate, Y-coordinate)], [color], [sprite 
number 


Sprite plane number [Cond | Integers from 0 to 31 
X-coordinate [Cond] Numeric type constants, variables, array variables, their 
expressions from —32 to 255 


Y coordinate [Cond] Numeric type constants, variables. array variables, their 
expressions from —32 to 191 
STEP (X-coordinate, Y -coordinate) 


[Omit } Previous location specified by the last graphic instruction 


Color [Cond] Integers from 0 to 15 
[Omit ] Current foreground color. 


Sprite number [Cond] For 8 x 8 dots, it is from 0 to 255. 
For 16 x 16 dots, it Is from O to 63. 
[Omit ] Same as the sprite plane number 
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© FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


1@ SCREEN 2 

20 SFRITE#¢1)=CHR#(&H18)+CHRS(&HS 

C>+CHRS¢&HEG)+CHRE CBHDBD+CHRE(&HE 

7) +CHRE(&H7E) +CHRS(&HZ4 9 +CHRSCRH4 2) 

36 X=8: Y=: DX=1:DY=1 

4@ PUT SPRITE @,¢%,¥3,,1 

SO X=K+DK2 VaV+DY 

66 IF %>2560R *<@ THEN DxR=-DH% 

70 IF ¥>196 OR Y<@ THEN DY=-DY 

86 GOTO 44 
A UFO shape is defined in line 20 as a sprite pattern assigned to sprite number 1. The sprite 
pattern is displayed on the screen by a PUT SPRITE staternent in line 40. The sprite plane 
number is 0. Since the display color is omitted, it is the sarne as the foreground color that 


was set. The UFO pattern appears to fly around the screen because the X, Y values that 
specify the display location are changed. 


SBS ae 


Reads data specified in a data staternent 


[) FORMAT 
READ variable [, variable] [, variable] ... 
Variable Cond,| Numeric type or string type. 


[) FUNCTION AND UTILIZATION 


Reads data in a sequence starting from the first data in the DATA statement that has the 
smallest number in a program, and assigns them sequentially to variables in the READ state- 
ment. 


@When a plural number of numeric type or string type variables are arranged in one READ 
statement, they are punctuated with a comma (,). 


@ The variable type must be in accord with the corresponding data 


1@ READ A,B,C,0F,E¢ 
2@ PRINT ABC, 0$,EF 
164 DATA 5,18,26,ABC,xV2 
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@When a plural number of READ statements exist in a program, the 2nd READ statement 
starts reading from data that is next to data read by a previous READ statement. 


@When a RESTORE statement is executed, the READ statement readout executed next 
returns to the smallest DATA statement after the line number specified by the RESTORE 
statement. 


EXECUTION EXAMPLE 


14 READ A>B;C 
24 READ D$,E$¢ 
38 PRINT AS Bs Cs DSs EF 
146 DATA 14,28, 38,ABC, DEF 
RUM 

16 28 38 ABCDEF 


a 


Inserts a comment statement in a program. 


OO FORMAT 


REM comment statement 


1 FUNCTION AND UTILIZATION 


A REM statement is used to insert a comment staternent so that a program list can be easily 
read 
EXECUTION EXAMPLE 


“ REM ti] |< I Bi Although a REM statement is displayed 
s sitipseonteend when a program is listed, it is skipped during 


oR PLAY "Teal EGEC1" program execution 


16 > MUS TC "a single quotation mark {') can be used in- 
"oh PLAY " TAACEGECI" stead of REM. 


16 PRIWT "NSA"! REM outrut 
26 PRINT "PERSONAL COMPUTER" ‘Outh 
Fut 


RUN Although a colon (:) is required when 
Mow REM is added after another statement, it 


FER S co HAL cl i FL T ER can be omitted by using“ ’ 
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GS RENUM (renumber) 


Renumbers the lines of a program 


OC) FORMAT 
RENUM [new starting line number) , [old starting line number) , [increment] 
New starting line Cond.| Integers from 0 to 65529. 
number [Omit | 10 
Old starting line [Cond. | Integers from 0 to 65529. 
number [Omit ] Smallest line number before execution. 
Increment [Cond.] Integers from 0 to 65529. 


[Omit ] 10 
C) FUNCTION AND UTILIZATION 


Used to renumber lines after a program correction 

@ The line number jumped to in a GOTO or GOSUB statement can be correctly renumbered 
by executing a RENUM statement. However, if the specified line number jumped to in a 
GOTO statement, etc. does not exist when RENUM is executed, the line number jumped 
to ina GOTO statement is not changed and an error occurs. 


EXECUTION EXAMPLE 


REHM Renumbers all lines from line 10 with an increment of 10 
HERS hy mh mim __ Renumbers all lines to the line numbers beginning 

REKUM 168,.168 with line 100, having an increment of 100. 

REHI Ir 1 1a Renumbers all lines to the line numbers beginning 


with line 100, having an increment of 10, 


RENUM 100,398,248 Renumbers the line 38 and after to the line 


numbers beginning with line 100, having an incre- 
ment of 20 


LI ST _ -Executes LIST 
15 FOR I=8 TO 16 

26 A=A+1 

23 PRINT A 

35 NEXT I 


Ok 

RENUM—————_ Executes RENUM 
Ok 

LIS? —————————Executes LIST again 


10 FOR I=@ TO 16 
20 A=A+I 

38 PRINT A 

49 NEXT I 
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MH RESTORE (restore) 


Specifies a DATA statement read by a READ statement. 


O FORMAT 
RESTORE [line number] 
Line number [Cond. Integers from 0 to 65529 


Omit DATA statement with the smallest line number 
C1 FUNCTION AND UTILIZATION 


A RESTORE statement is used when the same data has to be read a plural number of times. 
When a RESTORE statement is executed, the next READ statement starts reading data from 


the DATA statement with the smallest line number after the line number specified by the 
RESTORE statement 


EXECUTION EXAMPLE 


16 READ A:B,C 
26 READ D;E;F 
38 RESTORE 116 
46 READ G;H,I 


S@ PRINT ASBsCsDsEsF3sGsH31 
166 DATA 16,28, 36 
116 DATA 46,586.68 
run 
16 26 36 46 SG 66 46 6 66 


MS RESUME (resume) 


Returns execution to a main program after execution of the error processing 
routine 


CO) FORMAT 


RESUME | a number ] 
{ NEXT 


Line number Cond Integers from 0 to 65529 


Omit Line where an error occured 


CO) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


SC OTIN r SCC TIN Returns to s statement where an 
RESUME @ or RESUME error occurred 
RESUME 166 —— Returns to line 100 


{See the program example in ON ERROR GOTO.) 
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RIGHTS (right dollar) as 


Gives an arbitrary number of characters taken from the right of string data as 
string data 


1 FORMAT 
RIGHTS(XS, N) 
x$ [Cond.] String type constants, variables, array variables, their 
expressions. 
N Cond Numeric type constants, variables, array variables, their 
expressions from O to 255. 
Given value String type 


(1 FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 
PRINT RIGHT#¢"I LOVE TOKYO",5) 
TOKYO 
; When N is not an 
PRINT RIGHT#("I LOVE TORE" S28? ree cares 


TOKYO below the decimal point 
ee are omitted. 


When N is 0, a null 
string is given: 


PRINT RIGHT$¢"IT LOWE TOKYO",@ | 
no k 


RND (random) Sa 


Gives a random positive number less than 1 (including 0). 


(1) FORMAT 
RND(X) 
x [Cond] Numeric type constants, variables, array variables, their 
expressions 
Given value Numeric type 


© FUNCTION AND UTILIZATION 
When X is larger than 0 
Random numbers are always generated in the same sequence. 
16 FOR N=1 TO 14 
26 PRINT RND¢13 
38 NEXT N 
RUN 
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-59521943994623 
.1965862786560158 
-76597651772823 
»57756392935958 
»73474759503023 
.184268129997598 
»SPA7S3779H5223 
-94954151651558 
»63799556899423 
~47041117641358 


When X is negative 
Generates a series that corresponds to the value of X, and after that generates random num- 
bers with this series. 
14 PRINT RND¢-1) 
26 FOR H=1 TO 18 
38 PRINT RND¢CHN) 
4@ NEXT N 
RU 
~84389S28420321 
~8962486516692 
»21669655852361 
~S2651 7 3630584 
4777512433653 1 
» 2989147884636 
»12971184681661 
8977778174238 
»99157866175541 
» 835389696666 
»63962641386221 


R| When X is 0 


Gives the sare value as that generated before. 


19 PRINT FHDt 13 
2H FRIHT RHDGGS 
38 PRIWT FRHOG-1) 
4H PRIWT FHECH) 
RL H 
po eHe 194 S99dHs3 
259521943 994¢6e23 
84269827047 0821 
~8438982042G87 1 
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SHES 6, eee ERS 


Executes a program from a specified line 


O FORMAT 
RUN [line number] 
Line number Cond] Integers from O to 65529. 
[Omit ] Executes from the starting line 


1 FUNCTION AND UTILIZATION 


When RUN is executed, a program is executed after all variables are undefined (numeric 
variables are set to 0, and string variables are set to null strings). After program execution has 
been terminated, a command wait status occurs. 

@ Press [STOP] to temporarily stop program execution. Execution is resumed by pressing it 


again as 
Press |CTRL]} and [STOP] to interrupt a program. In this case, it can be resumed by a CONT 
command 


Bet ECR REP 


Saves a BASIC program on a specified device 


C] FORMAT 
SAVE “device name [file name)" 
Device name [Cond] CAS: .... Cassette tape 
CRT , Text mode screen 
GRP Graphic mode screen 
LPT Printer 
File name [Cond] String within 6 characters. If 7 or more characters are 


specified, the 7th character and after are ignored. 


Omit Null string 
C) FUNCTION AND UTILIZATION 
When CAS: is specified as a device name, a BASIC program in memory is saved on cassette 
tape in an ASCII format 
EXECUTION EXAMPLE 
SAVE" CAS? PROG" 


@ A program to be merged with a program in memory by a MERGE statement must be saved 
with an ASCII format 
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SRB SCREEN (sc00 0) RINGS SIE 


Sets the screen display mode, sprite size, key sound or no key sound, and the 
cassette interface baud rate, and also selects the type of printer. 


O FORMAT 
SCREEN [mode], [sprite size] , [key click switch], [baud rate) , [ printer type] 

Mode 0, 1; 20n 3 
Current mode. 

Sprite size 0, 1,2 or 3. 
Current size. 

Key click switch 0 or integers from 1 to 255. 
Current state. 

Baud rate lor 2. 
Current baud rate. 

Printer type Integers from 0 or 1 to 255. 
Current printer type. 


Modes 
Specified value 
40 characters x 24 lines Text mode 


32 characters x 24 lines Text mode 


High resolution graphic mode 
Multi-color mode 


Sprite size 


Specified value 


8 x 8 dot unmagnified 
8 x 8 dot magnified 


16 x 16 dot magnified 


Key click switch 


Specified value Key depression sound 


ae re No 
Other than 0. * Yes 


* Range from 1 to 255. 


ae 1200 baud 
ee 


*Cassette interface baud rate. 
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Printer type 


Specified value | Printer = 
MSX printer*® 
Other than O* Non MSX printer*** 


* Range from 1 to 255. 


** A printer compatible with MSX personal computers with graphic characters. 
*** For non MSX printers, graphic characters are converted to spaces. 


Initial value specification and omission 


When a specification is omitted, the presently selected mode is maintained. The initial state 


is as follows. 
Mode 40 characters x 24 lines text mode 
Sprite size : 8x 8 dot unmagnified 
Key click switch Key click sound 
Baud rate 1200 baud 
Printer type : MSX printer 


EXECUTION EXAMPLE 


1@ SCREEN 8, » 1—— 40 character x 24 line text made, no key 
click sound. (WIDTH 37,24) 

16 SCREEN >; »2————Baud rate is selected as 2400 baud. 

168 SCREEN 2; 5 ———_ High resolution graphic mode, Sprite is 16 


x 16 dot magnified 

16 SCREEN 2 

26 FOR 1l=6 TO 255 

3H PSET ¢I,18@) 

46 NEXT I 

$4 GOTO 56 
When program execution has been terminated, the screen returns to the text mode (SCREEN 
O or 1). As a result, when the graphic mode is to be maintained, program execution is as 


shown in line 50 of the above program. Press [CTRL] and [STOP] at the same time to stop ex- 
ecution. 


SOU 0, RIGS aS aS eee seed 


Gives 1 when numeric data is positive, 0 when it is 0, and —1 when it is negative. 


O FORMAT 
SGN(X) 
x [Cond.] Numeric type constants, variables, array variables, their 
expressions, 
Given value Integer type. 


(J FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


16 INPUT A 


26 IF SGN¢AS=-1 THEN PRINT "Negative" 
36 60TO 148 


“‘Negative"’ is displayed in line 20 only when the value assigned to A is negative. 
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NO" REE MRRRG: Sei aS SAS 


Gives the sine value for numeric data 


O FORMAT 
SIN(X) 
x [Cond.] Numeric type constants, variables, array variables, their 
expressions. (Unit: Radian) 
Given value: Floating point type constants from —1 to 1 


C) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRINT SINC3.1473) 
»86075983949239 
PRINT SINC66%#3.147188> 
.86575983949239 
@ To give X in degree units, use the formula SIN (X #7/180). 


EE SOUND (sound) Sa 


Generates sound effects by writing data directly to the PSG (Programmable Sound 
Generator) register 


0 FORMAT 
SOUND register number, expression 
Register number [Cond. Integers from O to 13. 
Expression [Cond] Constants, variables, array variables, their expressions 


within the determined range for each register 
PSG register functions and the write data range 


Register No. Function Data range 


Channel A frequency 


_- 
Channel B frequenc 
- us 0— 15 
0 — 255 
Channel C frequenc — — 
i isincinal 0-15 
Noise frequency 0—31 
Selects a channel for tone and noise 0-63 
generation. | i 
Channel A volume 0-—15 
Channel B volume ; Volume variation 
“ . occurs when 16 is 
Channel C volume selected. 
as 0 — 255 
Volume variation pattern frequency we 
0 — 255 
Volume variation pattern selection O—14 
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CO) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


16 SOUND 6:56 
28 SOUND 1:1 


Sets the Channel A frequency to 400 Hz. 


34 SOUND 7,69 ————‘Selects a Channel A tone. 
446 SOUND 8, 8——~*——\Selects the Channel A volume. 


When this program is executed, a 400 Hz sound is continuously output. 
Press [CTRL] +[STOP] to stop this. 


SPACES (space dollar) is 


Gives an arbitrary number of spaces as string data 


() FORMAT 
SPACES(N) 
N [Cond.] Numeric type constants, variables, array variables, their 
expressions from 0 to 255. 
Given value String type. 


[) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRIHT SPACE$¢533 "BC" 
HEC 
T=" spaces 


@ When N is not an integer value, figures below the decimal point are omitted. 


IRR RS aa ee 


Outputs an arbitrary number of spaces. 


(J FORMAT 
SPC(N) 
N _Cond.} Numeric type constants, variables, array variables, their 


expressions from 0 to 255. 
Given value String type. 
CL] FUNCTION AND UTILIZATION 


The SPC function can only be used in PRINT and LPRINT statements. 
EXECUTION EXAMPLE 


PRINT "ABC": SPACE$(1093 "DEF" 
RBC DEF 
$$ $$ 
10 spaces 


@ When N is not an integer value, the decimal point are omitted. 
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PRS SPC ON (SRSA eRe SIRES: 


SPRITE OFF 
SPRITE STOP 


Validates, invalidates, or holds an interrupt caused by a sprite overlap. 


0 FORMAT 


SPRITE ON — Interrupt valid 
SPRITE OFF — Interrupt invalid 
SPRITE STOP — Interrupt hold 


1 FUNCTION AND UTILIZATION 


A command used to actually validate, (SPRITE ON), invalidate (SPRITE OFF), or hold 
(SPRITE STOP) an interrupt after an interrupt caused by sprite overlap is declared by an ON 
SPRITE GOSUB statement. 


(See chapter 2.) 


EE SPRITES (sprite dollar) a 


Defines sprite pattern data 


O FORMAT 
SPRITES(sprite number) 
Sprite number Cond.} When 8 x 8 dots — Integers from 0 to 255 


When 16 x 16 dots — Integers from 0 to 63 
(1 FUNCTION AND UTILIZATION 


When the sprite pattern is defined for the SPRITES variable, it is maintained as a specified 
sprite number pattern. See chapter 2. 


SOR (square oct) 


Gives the square root value of numeric data 


CO FORMAT 
SQR(xX) 
x Cond.| Numeric type constants, variables, array variables, their 
~ expressions over 0 
Given value: Numeric type 


C) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRINT SQR(186) 
16 
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STICK (stick) [a 


Gives the direction of cursor keys and joy sticks. 


C1 FORMAT 
STICK(N) 1 
8 Up 2 
N 0, 1 or 2. Left up Right up 
Given value Integer type. “he, 

(1) FUNCTION AND UTILIZATION 7 9 3 
Gives the direction of cursor keys when N=0, Left Center Right 
that for joystick 1 when N=1 and that for 
joystick 2 when N=2. The range of given 
values that indicate the direction is from 0 to f 6 4 
8. When no cursor key is pressed, or when Leftdown 5 Right down 
joysticks are centered, O is given. Down 
EXECUTION EXAMPLE 

1@ CLS 


29 x=14 

36 LOCATE X,1@:PRINT " " 
; KC) 

S@ IF D=@ THEN LOCATE #,1@:PRINT "*" 
6@ IF D=3 THEN K=X+1:1F 4328 THEN X=28 
3 IF D=? THEN X=xX-1°1F &<@ THEN X=6 


ue 


S@ LOCATE X,16:PRINT "*"s3 
9@ GOTO 34 


A program that moves “«"’ to the left and right on the screen by using the left and right 
cursor keys. The value given to variable D in line 40 depends on whether a cursor key is 
pressed or not. The X-coordinate, in which “'e"' is displayed by a given value, is modified in 
line 50, 60, and 70. 


ee = (as ER 


Interrupts program execution. 


(1) FORMAT 
STOP 


(J FUNCTION AND UTILIZATION 


When a STOP statement is executed, program execution is interrupted. 


@When a direct mode CONT statement is executed, execution restarts from the statement 
after the interrupted statement. 
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HEE STOP ON (stop on) as 


STOP OFF (stop off) 
STOP STOP (stop stop) 


Validates, invalidates or holds an interrupt by the [CT RL} + [STOP] key. 


(1 FORMAT 


STOP ON ~  — Interrupt valid 
STOP OFF — Interrupt invalid 
STOP STOP — Interrupt hold 


[© FUNCTION AND UTILIZATION 
Commands that actually validate (STOP ON), jovelidate (STOP OFF), or hold (STOP STOP) 
an interrupt after declaring an interrupt by [CTAL| [STOP] using an ON STOP GOSUB 


statement. (See page 50 for Interrupts) 


STRIG (stick trigger) ay 


Gives —1 when the space bar or a joystick trigger button is depressed, and 0 when 
they are not depressed 


O FORMAT 
STRIGIN) 
N [Cond Integers from 0 to 4 
Given value Integer type 


(1) FUNCTION AND UTILIZATION 
Gives the space bar status when N=0, joystick 1 trigger button status when N=1, N=3, and the 
joystick 2 trigger button status when N=2, N=4. The given value is 0 when they are not 


depressed and —1 when they are depressed 
EXECUTION EXAMPLE 


18 CLS 

26 COLOR ,C;C 

3@ IF STRIG¢G)=@ THEN GOTO 26 
46 C=C+1:IF C515 THEN C= 

98 GOTO 26 


A program that changes the color of the screen every time the space bar is depressed 
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HE STRIG ON(stick trigger on) 
STRIG OFF (stick trigger off) 


STRIG STOP (stick trigger stop) 


Validates, invalidates or holds an interrupt by the sapce bar or a joystick trigger 
button. 


1) FORMAT 
STRIG(n) ON) — Interrupt valid 
STRIG(n) OFF — Interrupt invalid 
STRIG(n) STOP — Interrupt hold 


Cond Numeric type constants, variables, array variables, their 
expressions from 0 to 4. 


C) FUNCTION AND UTILIZATION 
Specifies the space bar, joystick 1 or 2 trigger buttons used for an interrupt by “’n’’. The line 
number of the corresponding subroutine must be specified by an ON STRIG GOSUB state- 
ment. 


Value of n 
0 


Specifies 


Space bar 


Joystick 1 trigger button 1 


Joystick 2 trigger button 1 


Joystick 1 trigger button 2 


1 
2 
3 
4 Joystick 2 trigger button 2 


STRIG¢h) ON Validates a space bar interrupt. 
STRIGC 13> OF F—Invatidates a joystick 1 trigger button 1 interrupt. 


STR I 6 ¢ ? ) STa P’-Holds a joystick 2 trigger button 1 interrupt 


(See page 50 for Interrupts.) 


STR$ (convert to string) as 


Converts numeric type data to string type data 


CO) FORMAT 
STRS$(X) 
Xx [ Cond Numeric type constants, variables, array variables, their 
expressions 
Given value: String type 


© FUNCTION AND UTILIZATION 


When numeric data is negative, the first character of the given string data is —. When it is 0 or 
positive, the first character of given string data is a space. 
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EXECUTION EXAMPLE 
14 %=160:Y=206 
20 XF=STRSCKOEVS=STRECY) 
30 PRINT &X+¥ 
40 PRINT X$+'4 


RUM 
388 
166 266 
X$ Y$ 


STRINGS (string dollar) ay 


Gives the character of a given character code or the starting character of a given 
character string continuously by an arbitrary number as string data. 


O FORMAT 
STRINGSIN, J) 
STRINGSIN, X$) 
N Cond.| Numeric type constants, variables, array variables, their 
expressions from 0 to 255 
J Cond. | An arbitrary character code (See the Character Code 
Table on page 165.) 
x$ |Cond.| String type constants, variables, array variables, their 
expressions 
Given value String type. 


1) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRINT STRING#<( 18.78) 


FFFFFFFFFF 
PRINT STRING#(5> "ABC") 
AAAAA 


HE SWAP ( swap) 


Exchanges the value Of two variables 


CO) FORMAT 
SWAP variable, variable 
variable Numeric type or string type variables, array variables. 


The two variables must have the same type. 
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OC) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 
1@ A=3:B=5 
20 SWAP ASB 


38 PRINT "A="3A 
40 PRINT “B="3B 
RUN 

R= 5 

B= 3 


"Ts 3 RES a ea 


Moves the cursor from the beginning of a line to the right by the number of 
specified characters. 


O FORMAT 
TABIN) 
N Cond.| Numeric type constants, variables, array variables, their 


expressions from 0 to 255. 


(1) FUNCTION AND UTILIZATION 


The TAB function can only be used in PRINT and LPRINT statements. When N is 0, it is on 
the extreme left, and when it is a value in which 1 is subtracted from the number of char- 
acters on one line, it is on the extreme right. 


EXECUTION EXAMPLE 
PRINT TABCS); "AAR" 
AAA 


— Pr 7S 


5 spaces 
TAN (tanc00t) |i aaa ieee mee renal 


Gives the tangent value for numeric data 


O FORMAT 
TAN(X) 
x [ Cond. Numeric type constants, variables, array variables, their 
expressions. (Unit: radians) 
Given value Floating point type constant 
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O) FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


PRINT TANC3.14-3) 


1, 72992922069 


@ To give X in degree units, use the formula TAN (X#2/180) 


725 = eRe: 


Holds the value of a built-in timer. 


(] FORMAT 


TIME 
TIME=Expression 


Expression [Cond Constants, variables, array variables, their expressions 
from O to 65535. 


O FUNCTION AND UTILIZATION 


In regard to this variable, the value of a built-in timer is held during BASIC activation with the 
value advanced by 1 about every 1/50 second in a range from O to 65535. When 65535 is 
reached, it becomes 0 again 

The value of the variable can be rewritten with a LET statement. When the CPU is in an 
interrupt prohibition state (such as during cassette tape |/O), this timer is stopped. When the 
power is off, it does not operate 


EXECUTION EXAMPLE 
18 CLS: TIME=6 
28 LOCATE 12,8:PRINT INTCTIME-5@) 
38 GOTO 26 
This program continuously displays the integer of the value, in which the value of TIME is 


divided by 50 after making the TIME variable value become 0 once. The numeral is advanced 
by 1 about every second. 


GE TROFF (trace off) as 


Releases TRON to stop the display of executed line numbers 


O FORMAT 
TROFF 


[] FUNCTION AND UTILIZATION 


When a TROFF statement is executed in a direct or indirect mode during TRON statement 
execution, the display of a line number is released 
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BARE RON Choco on) RRR RA ia eae 


Displays executed line numbers. 


C) FORMAT 
TRON 


[1 FUNCTION AND UTILIZATION 


When a TRON statement is executed once by a direct or indirect mode, the line number 
executed after that is displayed on the text mode screen inside [ ]. It is used for program 


debug (correction), etc ; 
@When the screen in placed in a graphic mode by a SCREEN statement, the line number is 


not displayed 
EXECUTION EXAMPLE 


19 TRON 

26 FOR 1=6 TO 3 
38 A=I+1:FRINT A 
46 NEXT I 

3@ TROFF 

RUM 

C26)(36] 1 
C481(38) 2 
C49]036] 3 
C48)030] 4 
C48)058) 


JOR 0) Sasi MERI Se ae ae 


Gives the result obtained after the execution of a machine language routine that 
starts from an address defined by a DEFUSR statement. 


C) FORMAT 
USR [X] (1) 


x Cond.| Integers from 0 to 9. 
[Omit 0 
| Cond.] Numeric type or string type constants, variables, array 
variables 


Given value Depends on the user function 


C) FUNCTION AND UTILIZATION 


X is a user program number. The number specified by DEFUSRA is used. | is a variable or 
constant that indicates the value to be transferred from BASIC to a subroutine 


EXECUTION EXAMPLE 
DEFUSR@=&HEbO8 
MSUSRECT) 


Based on these statements, the subroutine after the address & HEOOO is executed with the 
resultant value given to BASIC. (See page 56 for Machine language subroutines.) 
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VAL (00110) GR EPEC IG is a 


Gives|string data as numeric data. | 


O FORMAT 
VAL(X$) 
x$ Cond.| String type constants, variables, array variables, their 
expressions that express numerals. 
Given value: Numeric type. 


() FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 
PRINT VALC"S") 
i—¥ 


PRINT WALE" 5S") 


| The space before string type data is ignored 


VARPTR (variable pointer) is 


Gives the starting address in memory where data assigned to a specific variable 
is stored 


O) FORMAT 
VARPTRivariable) 


variable [ Cond ] Numeric type and string type variables, array variables. 


(J FUNCTION AND UTILIZATION 


Gives the decimal starting address in memory where a value assigned to a variable is stored. 
The given value ranges from —32768 to 32767. If it is negative, the actual address is one in 
which the value is added to 65536. The VARPTR function is used when an address in memo- 
ry with data is transferred to a machine language subroutine for example 


EXECUTION EXAMPLE 
14 MAXFILES=5 
26 A=VARPTR( #1 > 
34 PRINT HEX#¢A>D 


46 Ax=15 

58 K=VARPTRCAX) 

64 N$=HEX#CXI SPRINT NF 
7@ END 

RUN 

EESS 

S866 


This program checks the address in memory where the value assigned to a variable (A%) is 
stored, and displays it after converting it to hexadecimal. 


Before calling the VARPTR, it is necessary to substitute numerical! values for all the variables 
used in the program concerned 
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GE VDP (video display processor) ia 


Used to read and write the VDP register content. 


CO FORMAT 


VDP (register number) 
VDP (register number) = expression 


Register number Integers from 0 to 8. 
Expression Constants, variables, array variables, their expressions 


from 0 to 255. 


OO FUNCTION AND UTILIZATION 


Used as a function to read the register content of the TMS9929A (VDP), the video display 
LSI of the MSX personal computer, or as a variable to write data directly to the register. 


VDP registers 
Followings are the bit assignment of the VDP registers. 


Register 0 
MSB 7 6 5 4 3 2 1 0 LSB 


External video signal 
(input if 1) 

Mode selection bit 3 
Register 1 


MSB 7 6 1 OLSB 


Sprite magnification 
(magnification if 1) 
Sprite size (8 x 8 if 0) 


Mode selection bit 1, 2 


Interrupt output specification 
Screen display ON/OFF (display if 1) 
4K/16K byte memory selection (4K if 1) 


Register 2. _MS87 5 5 4 3 2 1 0 LSB 


MSB LSB 


Ps}AafAu Av} Ao| As] A>] Als |e] Aa] Aa] As] Ao 


400H0 0010000000000 


Pattern name table 
base address 
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Register 3 


Register 4 


Register 5 


Register 6 


MSB 7 1 0 LSB 


ee 


LSB 

com wiesives bl As sas 
780H 0 O 0 1 1 7 Ooae oo Oo 

MSB 7 6 5 4 3 a 1 O LSB 


0 


MSB LSB 


uff nf] As] Ax|A2]As] As] Aa] Aa] 42] ] Ao 


800HO0 0 10000000000 0 


Pattern generator 
table address 


MSB 7 1 0 LSB 


Pat] Sprite attribute table base address = 


LSB 
Sprite attribute 
table address /3)Ann|An|Aw|Ao|As]A7] Ao] As |A|A3] Aa] Ai]A0 


(ONG OO 1 1 7 8 0 DO OO oO 0 ao 


MSB 7 1 0 LSB 


Po [oe [oe [o [o [ivwpmntion 


Sprite generator 
table address 


0000H 0 00000000000 0 0 
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Register 7 
MSB 7 6 5 4 3 2 1 oO LSB 


Text color ‘'1" Text color ‘O"/back drop color 
See irs 


16 color codes from OH to FH. 


Register 8 


5th sprite No. 
1 1 


== sprite No. 


Overlap flag 


5th sprite 


Interrupt flag 


Register 8 is a read-out dedicated status register while the other registers are write-in de- 
dicated. 


Precautions 


To accomplish screen operation with a VDP variable and by rewriting the’VDP register value, 
adequate knowledge of the TMS9929< is necessary. If the VDP register is carelessly rewritten, 
the screen display is not correctly performed. Therefore, precautions shall be taken to avold 


this. 


VPEEK (video RAM peek) a’ 


Reads data in the video RAM. 


O FORMAT 
VPEEK (address) 
Address [ Cond.] Integers from 0 to 16383. 


CO FUNCTION AND UTILIZATION 


Gives data written at a specified video RAM address. 
Since the base address of each table can be found by the BASE function, use the BASE 
function to check the video RAM address when the VPEEK function is used. 
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V 
W 


HE VPOKE (video RAM poke) ay 


Writes 1 byte data to video RAM. 


O FORMAT 
VPOKE address, expression 


Address Integers from O to 16383. 


Expression Cond.| Numeric type constants, variables, array variables, their 
expressions from 0 to 255. 


C) FUNCTION AND UTILIZATION 
Writes arbitrary data to a specified video RAM address. In regard to the video RAM address 
imap, since the base address of each table can be found with the BASE function, check the 
video RAM address with the BASE function when a VPOKE statement is used. 


SR) RR aE 


Waits until the 1/O port input reaches a certain value. 


O FORMAT 
WAIT port number, expression 1 [, expression 2) 


Port number expression 1, expression 2 


Numeric type constants, variables, array variables, their 
expressions from 0 to 255. 


1 FUNCTION AND UTILIZATION 


When a WAIT statement is executed, data is input from a specified I/O port and XOR (ex- 
clusive OR) with the value of expression 2 is given, then AND (logical product) of the result 
and the value of expression 1 is given. If the value obtained as explained above is 0, data from 
the 1/O port is continuously input and if it has a value other than 0, an advancement is made 
to the next line number. If expression 2 is omitted, its value is considered to be O. 


| Rs 


Specifies the number of characters per line in the text mode. 


O FORMAT 
WIDTH(number of characters) 


Number of characters | Cond.| 'ntegers from 1 to 40 in the Screen O text mode. 
Integers from 1 to 32 in the SCREEN 1 text mode. 


1 FUNCTION AND UTILIZATION 
EXECUTION EXAMPLE 


SCREEN @ 
WIDTH 46 


In the SCREEN O text mode, 40 characters are set per line. 
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CHAPTER 4 


SAMPLE PROGRAM 
oF Le ty ee er eee ae re re 154 
CRIP EE 2 tiviinnnnmoninmnnmamennenauN 155 


—153— 


SAMPLE 1 


A display color adjustment program is made using the SPRITE function and COLOR 
statements. 


16’ *** COLOR #+#* 

26 COLOR 15;1,1:SCREEN2,2 

36 OPEN "GRP:" FOR OUTPUT AS#1 

46 FOR S=1 TO 2:A¢="" 

58 FOR P=1 TO 32:READ DF 

66 AS=AFS+CHRSCVALC"GH"+D$) 92 NERT 

76 SPRITE$(S)=AF! NEXT 

86 FOR K=15 TO 2 STEP -1:¥=K#114+13 

90 FOR K=16 TO 75+K#5 STEP 2 

166 PUT SPRITE K;¢X;Y),K>1 

11@ PUT SPRITE K+15,¢X+8,9-16)9,K,2 

126 LINECK-4,¥4+39-¢CK-2, 4+129,K,BFiNEXT 
130 READ DS: PSETCK+30,4-139,1°PRINT#H1,0¢ 
146 S=SG+K#2:PLAY"USN=S3 32"! NEXT 

156 DRAW"BM15,15":PRINT#1, "Transparent" 
166 DRAW"BM15,26":FPRINT#1; "Black" 

176 DRAW"BM27,0":PRINT#1,"Press RETURN K 
ey," 

186 IF INKEY#<>CHR#(13> THEN 186 

196 COLOR 15,4;7:ENE 

266 DATA 1,2,4;0,17,13,21,23,47,4C,F6 
216 DATA CO,6,6,0,0,3F,7E,.FC,F8,F8,E6 
226 DATA CG,30,6,6,6,40,0,0,6,6 

230 DATA @,6;,6,0,0,0,;0,0,1,2,4,9,13,27 
246 DATA 4F,9F,6,0,.0,0,16,28,40,9E,3F 
256 DATA 7E;>FC;>F8;F6,E8,C8,86 

266 DATA White,Gray,Magenta>Dark Green 
278 DATA Lisht Yellow,Dark Yellow,Liaht 


Red 

286 DATA Medium Red,Sky Blue,Dark Red>Li 
aht Blue 

296 DATA Dark Blue,Lisht Green, Medium Gr 
een 
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SAMPLE 2 


Eight measures of Chopin's “Grande Valse Brillante’’ are played using the PLAY 
statement. Here the measure-by-measure music data are prepared in the DATA state- 
ments, and are read out successively by the READ statements for triple-chordal 
performance. 


146 CLS:FRINT"WALT2" 
24 READ A¢,B$,C# 

36 IF A¢=""" THEN END 
46 PLAY AF, B$,0$ 

58 GOTO 26 


?@ * DATA 


3 DATA W13,V18,V18 

38 DATA O4L4B-O0508E-3SF 

166 DATH RROSL4O 

118 DATA RRR 

128 DATA O4L4B-05E-8F386 

138 DATA RROSL4E- 

144 CATA RRR 

156 DATA O4L4B-O5F 36G8h- 

168 DATA RROSL4F 

178 DATH RRR 

136 DATA OSL16B-4B6-8RSB-R4SB-R48 
196 DATA OSLI6G46SRSGR48GR4S 
266 DATA O5L160-40-8RSD-R48D-R48 
218 DATA OSL4B-06C805B-sA- 
228 DATA OSL26R 

236 DATA OSL2D-C4 

248 DATA OSL4A-B-3A-86 

258 DATA O5SL2C-046-4 

268 DATH RRR 

278 CATA OSL4GA-868F 

288 DATA O4L2B-A-4 

2398 DATA RRR 

364 DATA OSL4FGSFSE- 

316 DATA O4L2A-64 

328 DATA RRR 

334 DATA "" 

348 OATA "" 

358 DATA "" 
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CHAPTER 5 


1. ERROR MESSAGES 
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1. ERROR MESSAGES 


When an error occurs, program execution is stopped, a command wait status occurs, 
and an error message is displayed. The cause of an error is concisely displayed as an 
error message. Error messages and actual examples of error causes are explained 
below. The numerals inside parentheses are error numbers. 


Bad file name (56) 


© File name is improper 
e A device name that cannot be specified by an OPEN, SAVE or LOAD statement, was specified. 


Bad file number (52) 


e A file number was used that exceeds the range specified by a MAXFILES = statement. 
e PRINT # statement execution was attempted with an unopened file number. 


Can‘t CONTINUE (17) 


* After an interruption, program was atternped to be restarted after modification. 
* A program does not exist. 
e A CONT statement was used in a program 


Device 1/O error (19) 


e Load prevented due to cassette tape or tape recorder. 
e Improper tape recorder level. 

« Command interrupted before load completion. 

¢ |/O unit error. 


Direct statement in file (57) 


e A statement in an ASCII program being loaded does not have a |ine number, 
e An attempt was made to load a file other than that of a BASIC program (such as a data file). 


Division by zero (11) 


e Execution of division by zero was attempted. 
e Execution of division by an undefined variable was attempted. 


File already open (54) 


e An attempt was made to reopen an opened file. 


File not open (59) 
e Execution of a PRINT# or INPUT# etc. staternent was attempted by using a file number that 
was not opened by an OPEN statement. 


Ilegal direct (12) 


e Execution of a statement that can only be used in a program, such as a DEF FN statement, was 
attempted by a direct command. 


Illegal function call (5) 


¢ A wrong value was used in a command. 
e Value of a function is outside the tolerance range. 


Input past end (55) 
e Although all file data was read, read was attempted again. 
e A file does not contain data. 
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Internal error (51) 
e BASIC interpreter is abnormal. 


Line buffer overflow (25) 


© Input line buffer is full. 


Internal error (51) 
e BASIC interpreter is abnormal. 


Line buffer overflow (25) 


@ Input line buffer is full. 


Missing operand (24) 
e@ No parameter exists after a command. 
@ Required parameters are incomplete. 


NEXT without FOR (1) 


e@ An executed NE XT statement has no corresponding FOR statement. 
e Execution was transferred by a GOTO statement to somewhere inside a FOR — NEXT loop. 


NO RESUME (21) 


e An error processing routine has no RESUME statement. (An error processing routine must end 
with END, RESUME, or ON ERROR GOTO 0.) 


Out of DATA (4) 


¢ During READ statement execution, either no data or insufficient data exists. 


Out of memory (7) 

@ Program too long. 

@ Too many variables used. 

e Array too large. 

e The multi-structure of a FOR — NEXT or GOSUB — RETURN statement is too long. 


Out of string space (14) 


¢ Character area is exceeded. 
¢ The character area specified by a CLEAR statement is too small. 


Overflow (6) 


e Numeric type data or an arithmetic result exceeds the range that can be handled. 
e An address parameter is outside a specified range. 


RESUME without error (22) 


e A RESUME statement has no corresponding ON ERROR statement. 

e A transfer to an error processing routine by a GOTO statement. 

e Since no END statement exists at the end of a main routine, an error processing routine is con- 
tinuously executed. 


RETURN without GOSUB (3) 

e A RETURN statement has no corresponding GOSUB statement. 

e Transfer to a subroutine by a GOTO statement. 

. Since no END statement exists at the end of a main routine, a subroutine was continuously 
executed. 
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Redimensioned array (10) 


® An atternpt was made to define overlapping arrays with the same name. 
e Array variables were used without being defined by a DIM statement, then they were defined. 


String formula too complex (16) 
© A one line character expression is 100 complicated. 


String too long (15) 


*® A character variable was assigned a value that exceeded 255 characters. 


Subscript out of range (9) 


e A subscript was used that exceeded the size declared by a DIM statement. 
e A subscript exceeding 11 was used for an array variable not declared by a DIM statement. 


Syntax error (2) 
e An input statement is not in accordance with MSX-BASIC grammar. 


Type mismatch (13) 


e The types of the left and right sides of LET, INPUT and READ statement are different. 
e A logical operation was attempted to string type data. 
e The type of data specified by a function is a mismatch. 


Undefined line number (8) 


¢ A non existing line number was specified ina GOTO, GOSUB, or RESUME statement. 
e At RENUM statement execution, a non existing line mumber was specified with a GOTO 
statement etc, 


Undefined user function (18) 
« An attempt was made to use a user function not defined by a DEFFN statement. 


Unprintable error (23, 26-49, 60-255) 


© An error occurred that has no error number. 
© An error occurred because the number of an unprintable error was specified in an ERROR 
statement. 


Verify error (20) 


¢ The program on cassette tape is different from the program in memory. 
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1. MEMORY MAP 


&HO000 


MSxX-BASIC 
ROM 


User 
area 2 


&H8000 


When 32K, 
64K byte 
&HCOOO RAM Is 
installed 
User When 16 K 
area | byte RAM 
is installed 


&HF380 


See the Operating Instructions for the RAM capacity. 


&HFFFF 
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USER AREA CONFIGURATION 


Array variable 
area 


Character string 
area 
File control 
block 


&H8000 
(&HCOOO) 


&HF37F 


Program area 
A program is stored with line numbers. 


Variable area 
Stores numeric type data and pointers for string type data. 


Array variable area 
Stores array variable data. Stores the pointer for the character string area if it isa string type. 


Free area 
Unused area. The size can be known with the FRE function. 


Stack area 
The stack area is used to save a return address. 


Character string area 
Stores a character string included in a string type variable or array variable. 
The size can be specified with a CLEAR statement. 


File control block 
Used during file Input/Output. 
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2. 1/0 PORT ALLOCATION 


[tization] —_PonNo | ——~Apwliction 
RS-232-C &H80 Data read-out/write-in 

Mode set (during write-in) 

ee! Status (during read-out) 

Printer Strobe (during write-in) 

aren Status (during read-out) 


&H98B 


Data write-in 


VDP Data read-out/write-in with video RAM: 


Command, address set (during write-in) 
Status (during read-in) 


Address latch (write-in) 


Data write-out 


Data read-out/write-in for port A 

(Memory slot select) use. 

Data read-out/write-in for port B 

(key borad scan) use. 
Data read-out/write-in for port C 
(cassette). 


Mode set (write-in) 


@ |/O addresses from &HOO to &H7F are not used. Addresses other than the above 
addresses of the address among &H80 to &HFF are reserved for system use. 
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3. CHARACTERS 


CHARACTERS HANDLED BY MXS-BASIC 


The characters shown in the following character code table can be displayed. 


i. 
® 
~~ 
Oo 
x 
te 
o 
— 
o 


code} character 


character 


code| character 


Hexa- 
decimal 
code 


See OC ERSCEREEE 
- -—\|=— 


Tee) 
Sim 


Rin ~ 
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a ve 
5 
; / ee 
bo Ni 


m—IN 
00 | 00 
aoe ee 


>| 0]: 
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Characters whose character code consists of 2 bytes 


Characters of codes 1 to 31 (decimal) in the above table have 2-byte 
character codes. Their codes in the table should be preceded by the code 
1 and the codes listed in the table should be added by 64 (decimal). 


Input/output of character codes 
Input from the keyboard 
Normal characters ..... 1-byte code is input. 
Example: Code 65 (decimal) for the 
character “A” 
2-byte code characters ...... 1 and the other code are input. 
Example: Code 1 and 67 for the 
character "@" 
Output using CHR$ function 
Normal characters ..... 1-byte code is used as a parameter. 
Example: CHR$ (66) for the character “B" 
2-byte code characters ..... 2 CHR$ functions are used, of which the 
first one is CHR$(1), and the following 
one is a CHR$ function using the 
above listed code as a parameter. 
Example: CHR$(1); CHR$(68) for the 
character “@" 
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4.\CTRL| KEY FUNCTIONS 


In addition to the edit key, MSX-BASIC is provided with special functions just by pressing 
the |CTRL| key simultaneously with another key. 


Key pressed Function 
CTRL +[B] Moves the cursor to the beginning of a word (character group punc- 


tuated by a space). When the cursor is at the beginning of a word, it is 
moved to the beginning of the word just before. 


CTRL] +[C] Releases the input wait state or automatic line number generation by 
the AUTO command to return to the command wait state. 


+[E] Provides erasure from the cursor location to the last line. 
+[F] Moves the cursor to the beginning of the next word. 
+) 
(TAL) +f] Same as the [BS] key. 
[erat] +[7] | Somes the [TAB] key. 


4 —— 


Generates a beep sound. 


(cTRL]+(J] Moves the cursor 1 line below. 
(CTAC]+[K] | sameas [HOME] 
(ETAL]+[C] | Same as [SHIFT] + [HOME]. 
[erac]+[m] | sameas the [RETURN] key. 


CTRL +[N] Moves the cursor to a location next to the last character ina line. 


(CTRL) +[R]} Same as the [INS] key. 
: r 
+{U] Erases all the characters on a line. 


(crrt] +(x] Te a (SELECT]. Undefined in MSX-BASIC. 
(erAc)+ (J Sema as a ure key. 
(erat) +(T] Same as [ESC]. Undefined in MSX.BASIC. 
(ea +.) Same as f= erase hanes 

(erAc)+ [7] Same as (J cursor key. 


[cTRc]+[_] Same as @) cursor key. 
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Jl: eee 64 
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Binary expression ........ 14 
BLOAD (binary load) ..... 65 
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BSAVE (binary save) ..... 66 


[c] 


CALL ences 1 ein oes 66 
CDBL (convert to double 

precision) ......csceces 67 
CHMTUVEL: ibieiie: dtecerecenica shane 137 
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Character string area...... 163 
Character code .......... 165 
CINT (convert to 

WE iis Veena se 67 
GIRGEE sasu< sc aseare sos 68 
CLEAR seins to vans ves 69 
CLOAD/CLOAD? 

(cassette load) ...... 69, 70 


CSE sca trary exsrrcardeagy, mare 70 
CLS (clear screen) ....... 71 
SOIOMUED | ears. sceatoaca waters 3 
COLGB crn acrancas tvs 71 
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CONT (continue) ........ 72 
COS (cosine) .....sccse- 72 
CSAVE (cassette save) .... 72 
CSNG (convert to single 
RINNE wicnaccnies vous 73 
CSRLIN (cursor line) ..... 73 


[D] 


GARI. 250k eeeEs RE 74 
Decimal expression....... 14 
DEFFN (define function) “g 
DEFINT (define integer) 

eT TO 75 

DEFSNG (define single 
DFOCIIGN) s oscctcstes. wines 75 

DEFDBL (define double 
INGO) saccecrs nae 75 

DEFSTR (define string) 

Ste wisrstats cor schccrauetls Stacey 75 
DEFUSR (define user) ... 76 
Ue ie wairntiaca EN 76 
Device name ............ 43 
DIM (dimension) ........ 77 
DiPOOt MOE i ojsiisereer6:e oxere 6 
Double precision ........ 13 
| re 77 
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[e] 


PND. s sasseas scat see 81 
EOF (end of file) ........ 81 
EQV (equivalence) ....... 19 
PRASES sciatica ne wrats 82 
ERL (error line) ......... 82 
ERR GOR): ao: aiesese eiacdsrsie 82 
ERO ferctecarinetereG-a neat 83 
ErfOr M@SSAGE ..0k cies bees 158 
Error NUMDEM 66s a :s.c00.0%0 158 
EXP (exponential) ....... 83 


PAN oc crah sane, Sansacigidennteraaend 42 
FUG RAMG cimiiwcciensa wave 43 
IK .osicaltossererinipiavaiwrncbeal wee 84 
FOR! NEO csccsssttarseacs 84 
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